@akanjs/devkit 2.3.12 → 2.3.13-rc.1

package/akanConfig/akanConfig.test.ts

@@ -4,7 +4,6 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import type { PackageJson } from "../types";
 import { AkanAppConfig, AkanLibConfig } from "./akanConfig";
-import type { DeepPartial, LibConfigResult } from "./types";
 
 const akanPackageJson = JSON.parse(
   fs.readFileSync(path.join(path.dirname(fileURLToPath(import.meta.url)), "../../../akanjs/package.json"), "utf8"),

package/akanConfig/akanConfig.ts

@@ -1,6 +1,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
+import type { AkanPlugin } from "akanjs";
 import { type AkanI18nConfig, resolveAkanI18nConfig } from "akanjs/common";
 import type { AkanImageConfig } from "akanjs/server";
 import type { App, Lib } from "../commandDecorators";
@@ -136,6 +137,8 @@ export class AkanAppConfig implements AppConfigResult {
   secrets: string[];
   baseDevEnv: BaseDevEnv;
   libs: string[];
+  /** Live-only: plugins declared in this app's `akan.config.ts` (never serialized). */
+  plugins: AkanPlugin[];
   domains = new Set<string>();
   subRoutes = new Map<string, Set<string>>();
   basePaths = new Set<string>();
@@ -146,11 +149,13 @@ export class AkanAppConfig implements AppConfigResult {
     rootPackageJson: PackageJson,
     config: DeepPartial<AppConfigResult>,
     baseDevEnv: BaseDevEnv,
+    plugins: AkanPlugin[] = [],
   ) {
     this.app = app;
     this.rootPackageJson = rootPackageJson;
     this.libs = libs;
     this.baseDevEnv = baseDevEnv;
+    this.plugins = plugins;
     this.#applyRoutes(config?.routes);
     this.defaultDatabaseMode = config?.defaultDatabaseMode ?? "single";
     this.externalLibs = config?.externalLibs ?? [];
@@ -341,15 +346,18 @@ CMD [${command.map((c) => `"${c}"`).join(",")}]`;
       app.workspace.getLibs(),
       app.workspace.getPackageJson(),
     ]);
-    const config = typeof configImp === "function" ? configImp(app) : configImp;
-    return new AkanAppConfig(app, libs, rootPackageJson, config, baseDevEnv);
+    const resolved = typeof configImp === "function" ? configImp(app) : configImp;
+    const { plugins, ...config } = (resolved ?? {}) as DeepPartial<AppConfigResult> & { plugins?: AkanPlugin[] };
+    return new AkanAppConfig(app, libs, rootPackageJson, config, baseDevEnv, plugins ?? []);
   }
   #resolveProductionDependencyVersion(lib: string) {
     const rootVersion = this.rootPackageJson.dependencies?.[lib] ?? this.rootPackageJson.devDependencies?.[lib];
     if (rootVersion) return rootVersion;
+    // Fall back to the framework package's own (peer)dependencies so plugin-declared runtime
+    // packages (e.g. firebase for the push plugin) resolve a version without the framework
+    // hardcoding a per-feature package list.
     const akanPackageJson = getAkanPackageJson();
-    if (AKAN_RUNTIME_PACKAGES.has(lib))
-      return akanPackageJson.dependencies?.[lib] ?? akanPackageJson.peerDependencies?.[lib];
+    return akanPackageJson.dependencies?.[lib] ?? akanPackageJson.peerDependencies?.[lib];
   }
   #getProductionRuntimePackages() {
     return [
@@ -451,14 +459,18 @@ function mergeImageConfig(config: Partial<AkanImageConfig> = {}): AkanImageConfi
 export class AkanLibConfig implements LibConfigResult {
   lib: Lib;
   externalLibs: string[];
-  constructor(lib: Lib, config: DeepPartial<LibConfigResult>) {
+  /** Live-only: plugins declared in this lib's `akan.config.ts` (never serialized). */
+  plugins: AkanPlugin[];
+  constructor(lib: Lib, config: DeepPartial<LibConfigResult>, plugins: AkanPlugin[] = []) {
     this.lib = lib;
     this.externalLibs = config?.externalLibs ?? [];
+    this.plugins = plugins;
   }
   static async from(lib: Lib) {
     const [configImp] = await Promise.all([import(`${lib.cwdPath}/akan.config.ts`).then((mod) => mod.default)]);
-    const config = typeof configImp === "function" ? configImp(lib) : configImp;
-    return new AkanLibConfig(lib, config);
+    const resolved = typeof configImp === "function" ? configImp(lib) : configImp;
+    const { plugins, ...config } = (resolved ?? {}) as DeepPartial<LibConfigResult> & { plugins?: AkanPlugin[] };
+    return new AkanLibConfig(lib, config, plugins ?? []);
   }
 }
 

package/akanConfig/types.ts

@@ -1,9 +1,16 @@
 export type {
   AkanConfigFile,
+  AkanExecutor,
   AkanMobileConfig,
   AkanMobileTargetConfig,
+  AkanNativeContext,
+  AkanPlugin,
+  AkanPluginCapacitorConfig,
   AkanRouteConfig,
+  AkanScanInfo,
+  AkanSyncContext,
   AppConfig,
+  AppConfigInput,
   AppConfigResult,
   AppScanResult,
   Arch,
@@ -12,11 +19,13 @@ export type {
   DockerConfig,
   FileConventionScanResult,
   LibConfig,
+  LibConfigInput,
   LibConfigResult,
   LibScanResult,
   MobileEnv,
   MobilePermission,
   PkgScanResult,
+  PluginRuntimeContext,
   ScanResult,
   WorkspaceScanResult,
 } from "akanjs";

package/capacitorApp.ts

@@ -6,8 +6,9 @@ import { select } from "@inquirer/prompts";
 import { MobileProject } from "@trapezedev/project";
 import type { AndroidProject } from "@trapezedev/project/dist/android/project";
 import type { IosProject } from "@trapezedev/project/dist/ios/project";
+import type { AkanNativeContext, AkanPlugin } from "akanjs";
 import { capitalize } from "akanjs/common";
-import type { AkanMobileTargetConfig } from "./akanConfig";
+import type { AkanMobileTargetConfig, MobilePermission } from "./akanConfig";
 import { type AppExecutor, CommandExecutionError } from "./executors";
 import { FileEditor } from "./fileEditor";
 import { resolveMobilePath, targetHtmlFilename } from "./mobile";
@@ -26,7 +27,6 @@ interface RunIosConfig extends RunConfig {
 interface PrepareConfig extends RunConfig {}
 
 type MobileCommandEnv = Record<string, string | undefined>;
-type IosApnsEnvironment = "development" | "production";
 
 export type IosRunTargetKind = "device" | "simulator";
 export interface IosRunTarget {
@@ -131,9 +131,6 @@ const asString = (value: unknown) => (typeof value === "string" ? value : undefi
 
 const firstString = (...values: unknown[]) => values.find((value): value is string => typeof value === "string");
 
-const resolveIosApnsEnvironment = ({ operation }: Pick<RunConfig, "operation" | "env">): IosApnsEnvironment =>
-  operation === "release" ? "production" : "development";
-
 const scoreIosDeviceTarget = (target: IosRunTarget) => {
   const state = target.state?.toLowerCase() ?? "";
   return (state.includes("available") ? 4 : 0) + (state.includes("wired") ? 2 : 0) + (state.includes("paired") ? 1 : 0);
@@ -557,6 +554,9 @@ export class CapacitorApp {
   readonly iosProjectPath = "ios/App";
   readonly androidRootPath = "android";
   readonly androidAssetsPath = "android/app/src/main/assets";
+  //* Accumulates iOS entitlements contributed by deep links and plugins during a prepare,
+  //* then flushed to App/App.entitlements once (see #flushIosEntitlements).
+  #iosEntitlements: Record<string, string | string[]> = {};
   constructor(
     private readonly app: AppExecutor,
     readonly target: AkanMobileTargetConfig,
@@ -605,6 +605,7 @@ export class CapacitorApp {
     await this.#applyIosMetadata();
     await this.#applyPermissions({ operation, env });
     await this.#applyDeepLinks("ios", { operation, env });
+    await this.#flushIosEntitlements();
     await this.project.commit();
     await this.#generateAssets({ operation, env });
     this.app.verbose(`syncing iOS`);
@@ -992,13 +993,52 @@ export class CapacitorApp {
     await this.project.android.setAppName(this.target.appName);
   }
   async #applyPermissions({ operation, env }: Pick<RunConfig, "operation" | "env">) {
+    const plugins = await this.app.collectPlugins();
+    const nativePlugins = new Map<MobilePermission, AkanPlugin[]>();
+    for (const plugin of plugins) {
+      const permission = plugin.capacitor?.permission;
+      if (!permission || !plugin.capacitor?.configureNative) continue;
+      const claimants = nativePlugins.get(permission) ?? [];
+      claimants.push(plugin);
+      nativePlugins.set(permission, claimants);
+    }
     for (const permission of this.target.permissions ?? []) {
-      if (permission === "camera") await this.addCamera();
-      else if (permission === "contacts") await this.addContact();
-      else if (permission === "location") await this.addLocation();
-      else if (permission === "push") await this.addPush({ operation, env });
+      const claimants = nativePlugins.get(permission);
+      if (!claimants?.length) {
+        this.app.logger.warn(
+          `Mobile target '${this.target.name}' declares permission '${permission}' but no plugin configures it. ` +
+            `Depend on a lib (e.g. @libs/util) whose akan.config declares a plugin with capacitor.permission '${permission}'.`,
+        );
+        continue;
+      }
+      const ctx = this.#makeNativeContext({ operation, env });
+      for (const plugin of claimants) await plugin.capacitor?.configureNative?.(ctx);
     }
   }
+  #makeNativeContext({ operation, env }: Pick<RunConfig, "operation" | "env">): AkanNativeContext {
+    return {
+      appPath: this.app.cwdPath,
+      executor: this.app,
+      target: this.target,
+      operation,
+      env,
+      setIosUsageDescriptions: (descriptions) => this.#setPermissionInIos(descriptions),
+      updateIosInfoPlist: async (values) => {
+        await Promise.all([
+          this.project.ios.updateInfoPlist(this.iosTargetName, "Debug", values),
+          this.project.ios.updateInfoPlist(this.iosTargetName, "Release", values),
+        ]);
+      },
+      addIosEntitlements: (entitlements) => this.#addIosEntitlements(entitlements),
+      editIosAppDelegate: (transform) => this.#editIosAppDelegate(transform),
+      addAndroidPermissions: (permissions) => {
+        this.#setPermissionsInAndroid(permissions);
+      },
+      addAndroidFeatures: (features) => {
+        this.#setFeaturesInAndroid(features);
+      },
+    };
+  }
   async #applyDeepLinks(platform: "ios" | "android", { operation, env }: Pick<RunConfig, "operation" | "env">) {
     const deepLinks = this.target.deepLinks;
     if (!deepLinks) return;
@@ -1012,7 +1052,10 @@ export class CapacitorApp {
         });
         await this.#setUrlSchemesInIos(schemes);
       }
-      if (domains.length > 0) await this.#setAssociatedDomainsInIos(domains, { operation, env });
+      if (domains.length > 0)
+        this.#addIosEntitlements({
+          "com.apple.developer.associated-domains": domains.map((domain) => `applinks:${domain}`),
+        });
       return;
     }
     if (platform === "android") {
@@ -1036,7 +1079,10 @@ export class CapacitorApp {
       await this.#setDeepLinksInAndroid(schemes, domains);
     }
   }
-  #assertDeepLinkVerificationConfig(platform: "ios" | "android", { operation, env }: Pick<RunConfig, "operation" | "env">) {
+  #assertDeepLinkVerificationConfig(
+    platform: "ios" | "android",
+    { operation, env }: Pick<RunConfig, "operation" | "env">,
+  ) {
     const deepLinks = this.target.deepLinks;
     if (!deepLinks?.domains?.length) return;
     if (platform === "ios" && !deepLinks.ios?.teamId) {
@@ -1097,79 +1143,18 @@ export class CapacitorApp {
       await this.#clearRootCapacitorConfigs();
     }
   }
-  async addCamera() {
-    await this.#setPermissionInIos({
-      cameraUsageDescription: "$(PRODUCT_NAME) requires access to the camera to take photos.",
-      photoAddUsageDescription: "$(PRODUCT_NAME) requires access to the photo library to take photos.",
-      photoUsageDescription: "$(PRODUCT_NAME) requires access to the photo library to take photos.",
-    });
-    this.#setPermissionsInAndroid(["READ_MEDIA_IMAGES", "READ_EXTERNAL_STORAGE", "WRITE_EXTERNAL_STORAGE"]);
-  }
-  async addContact() {
-    await this.#setPermissionInIos({
-      contactsUsageDescription: "$(PRODUCT_NAME) requires access to the contacts to add new contacts.",
-    });
-    this.#setPermissionsInAndroid(["READ_CONTACTS", "WRITE_CONTACTS"]);
-  }
-  async addLocation() {
-    await this.#setPermissionInIos({
-      locationAlwaysUsageDescription: "$(PRODUCT_NAME) requires access to the location to get the user's location.",
-      locationWhenInUseUsageDescription: "$(PRODUCT_NAME) requires access to the location to get the user's location.",
-    });
-    this.#setPermissionsInAndroid(["ACCESS_COARSE_LOCATION", "ACCESS_FINE_LOCATION"]);
-    this.#setFeaturesInAndroid(["android.hardware.location.gps"]);
+  #addIosEntitlements(entitlements: Record<string, string | string[]>) {
+    Object.assign(this.#iosEntitlements, entitlements);
   }
-  async addPush({ operation, env }: Pick<RunConfig, "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() {
+  //* Generic in-place transform of ios/App/App/AppDelegate.swift (no-op if the file is absent).
+  //* Feature-specific native wiring (e.g. Firebase) lives in plugins, not the framework.
+  async #editIosAppDelegate(transform: (content: string) => string) {
     const appDelegatePath = path.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\nimport FirebaseCore");
-    }
-    if (!content.includes("import FirebaseMessaging")) {
-      content = content.replace("import FirebaseCore", "import FirebaseCore\nimport FirebaseMessaging");
-    }
-    if (!content.includes("FirebaseApp.configure()")) {
-      content = content.replace(/\n(\s*)return true/, "\n$1FirebaseApp.configure()\n\n$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("\n    func applicationWillResignActive", `${delegateMethods}\n    func applicationWillResignActive`);
-    }
-
-    if (content !== editor.getContent()) await editor.setContent(content).save();
+    const content = editor.getContent();
+    const next = transform(content);
+    if (next !== content) await editor.setContent(next).save();
   }
   async #setPermissionInIos(permissions: { [key: string]: string }) {
     const updateNs = Object.fromEntries(
@@ -1190,29 +1175,30 @@ export class CapacitorApp {
       this.project.ios.updateInfoPlist(this.iosTargetName, "Release", { CFBundleURLTypes: urlTypes }),
     ]);
   }
-  async #setAssociatedDomainsInIos(domains: string[], { operation, env }: Pick<RunConfig, "operation" | "env">) {
-    await this.#writeEntitlementsInIos(domains, { operation, env });
+  #serializeIosEntitlements(entitlements: Record<string, string | string[]>) {
+    const lines: string[] = [];
+    for (const [key, value] of Object.entries(entitlements)) {
+      lines.push(`  <key>${key}</key>`);
+      if (Array.isArray(value)) {
+        lines.push("  <array>", ...value.map((item) => `    <string>${item}</string>`), "  </array>");
+      } else {
+        lines.push(`  <string>${value}</string>`);
+      }
+    }
+    return lines;
   }
-  async #writeEntitlementsInIos(domains: string[], runConfig: Pick<RunConfig, "operation" | "env">) {
+  //* Write the accumulated iOS entitlements (from deep links + plugins) to App/App.entitlements
+  //* once per prepare. Skipped entirely when nothing contributed entitlements.
+  async #flushIosEntitlements() {
+    if (Object.keys(this.#iosEntitlements).length === 0) return;
     const entitlementsRelPath = "App/App.entitlements";
     const entitlementsPath = path.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>",
-      ...(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>",
-          ]
-        : []),
+      ...this.#serializeIosEntitlements(this.#iosEntitlements),
       "</dict>",
       "</plist>",
       "",

package/executors.ts

@@ -11,6 +11,7 @@ import { readFileSync } from "node:fs";
 import { copyFile, mkdir, readdir as readDirEntries, stat } from "node:fs/promises";
 import path from "node:path";
 import { pathToFileURL } from "node:url";
+import type { AkanPlugin, AkanSyncContext, PluginRuntimeContext } from "akanjs";
 import {
   capitalize,
   isRouteSourceFile,
@@ -24,11 +25,6 @@ import chalk from "chalk";
 import ts from "typescript";
 import { AkanAppConfig, AkanLibConfig, decreaseBuildNum, increaseBuildNum } from "./akanConfig";
 import { FileSys } from "./fileSys";
-import {
-  createFirebaseMessagingServiceWorker,
-  type FirebaseClientEnvConfig,
-  normalizeFirebaseClientConfig,
-} from "./firebaseMessagingSw";
 import { getDirname } from "./getDirname";
 import { Linter } from "./linter";
 import { AppInfo, LibInfo, PkgInfo, WorkspaceInfo } from "./scanInfo";
@@ -1087,7 +1083,7 @@ interface SysExecutorOptions {
   type: "app" | "lib";
 }
 
-const scanFacetDirs = ["ui", "webkit", "srvkit", "common"] as const;
+const scanFacetDirs = ["ui", "webkit", "srvkit", "common", "plugin"] as const;
 
 export class SysExecutor extends Executor {
   workspace: WorkspaceExecutor;
@@ -1548,27 +1544,71 @@ export class AppExecutor extends SysExecutor {
       writeLib: write,
     })) as AppInfo;
     if (write) await this.syncAssets(scanInfo.getScanResult().libDeps);
-    if (write) await this.#syncFirebaseMessagingSw();
+    if (write) await this.#runPluginSyncAssets();
     return scanInfo;
   }
-  //* firebase config 가 있으면 public/firebase-messaging-sw.js 를 1회 생성한다(있으면 스킵).
-  //* 서버 동적 라우트를 대체하는 정적 파일. env.client 파생이라 gitignore 되고 env 별로 재생성된다.
-  async #syncFirebaseMessagingSw() {
-    const swRelPath = "public/firebase-messaging-sw.js";
-    if (await FileSys.fileExists(this.getPath(swRelPath))) return;
-    const envClientPath = path.join(this.cwdPath, "env", "env.client.ts");
-    if (!(await FileSys.fileExists(envClientPath))) return;
-    let firebaseConfig: FirebaseClientEnvConfig | null = null;
-    try {
-      const envUrl = pathToFileURL(envClientPath);
-      envUrl.searchParams.set("t", String(Date.now()));
-      const envModule = (await import(envUrl.href)) as { env?: { firebase?: unknown } };
-      firebaseConfig = normalizeFirebaseClientConfig(envModule.env?.firebase);
-    } catch {
-      return;
+  //* build-time asset generation is delegated to plugins (e.g. the push plugin writes
+  //* public/firebase-messaging-sw.js). The framework itself no longer knows about firebase.
+  async #runPluginSyncAssets() {
+    const plugins = await this.collectPlugins();
+    if (!plugins.some((plugin) => plugin.syncAssets)) return;
+    const ctx = this.#makeSyncContext();
+    for (const plugin of plugins) await plugin.syncAssets?.(ctx);
+  }
+  #makeSyncContext(): AkanSyncContext {
+    return {
+      appName: this.name,
+      appPath: this.cwdPath,
+      executor: this,
+      getPath: (rel) => this.getPath(rel),
+      fileExists: (rel) => FileSys.fileExists(this.getPath(rel)),
+      writeFile: async (rel, content, opts) => {
+        await this.writeFile(rel, content, opts);
+      },
+      readEnvClient: async () => {
+        const envClientPath = path.join(this.cwdPath, "env", "env.client.ts");
+        if (!(await FileSys.fileExists(envClientPath))) return null;
+        try {
+          const envUrl = pathToFileURL(envClientPath);
+          envUrl.searchParams.set("t", String(Date.now()));
+          const envModule = (await import(envUrl.href)) as { env?: Record<string, unknown> };
+          return envModule.env ?? null;
+        } catch {
+          return null;
+        }
+      },
+    };
+  }
+  //* Aggregate plugins declared by this app's akan.config plus each of its lib dependencies'
+  //* akan.config. This is how a lib (e.g. libs/util) opts an app into a feature turnkey.
+  async collectPlugins(): Promise<AkanPlugin[]> {
+    const scanInfo = (await this.scan({ write: false })) as AppInfo;
+    const libDeps = scanInfo.getLibs();
+    const appConfig = await this.getConfig();
+    const collected: AkanPlugin[] = [...appConfig.plugins];
+    for (const libName of libDeps) {
+      const libConfig = await LibExecutor.from(this, libName)
+        .getConfig()
+        .catch(() => null);
+      if (libConfig) collected.push(...libConfig.plugins);
     }
-    if (!firebaseConfig) return;
-    await this.writeFile(swRelPath, createFirebaseMessagingServiceWorker(firebaseConfig), { overwrite: false });
+    const seen = new Set<string>();
+    return collected.filter((plugin) => {
+      if (seen.has(plugin.name)) return false;
+      seen.add(plugin.name);
+      return true;
+    });
+  }
+  async getPluginRuntimePackages(): Promise<string[]> {
+    const plugins = await this.collectPlugins();
+    const appConfig = await this.getConfig();
+    const ctx: PluginRuntimeContext = {
+      appName: this.name,
+      mobile: appConfig.mobile,
+      hasMobilePermission: (permission) =>
+        Object.values(appConfig.mobile.targets).some((target) => target.permissions?.includes(permission) ?? false),
+    };
+    return [...new Set(plugins.flatMap((plugin) => plugin.runtimePackages?.(ctx) ?? []))];
   }
   async increaseBuildNum() {
     await increaseBuildNum(this);

package/frontendBuild/devChangePlanner.ts

@@ -3,7 +3,7 @@ import type { ChangeKind, DevChangeAction, DevChangePlan, DevChangeRole } from "
 
 const SOURCE_EXTS = new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]);
 const CONFIG_BASENAMES = new Set(["akan.config.ts", "bunfig.toml", "tsconfig.json", "package.json"]);
-const BARREL_FACETS = new Set(["common", "srvkit", "ui", "webkit"]);
+const BARREL_FACETS = new Set(["common", "srvkit", "ui", "webkit", "plugin"]);
 const CLIENT_SUFFIXES = [".Template.tsx", ".Unit.tsx", ".Util.tsx", ".View.tsx", ".Zone.tsx", ".store.ts"];
 const SHARED_SUFFIXES = [".constant.ts", ".dictionary.ts", ".signal.ts"];
 const SERVER_SUFFIXES = [".service.ts", ".document.ts"];

package/frontendBuild/devGeneratedIndexSync.ts

@@ -1,7 +1,7 @@
 import { mkdir, readdir, readFile, rm, stat, writeFile } from "node:fs/promises";
 import path from "node:path";
 
-const BARREL_FACETS = new Set(["common", "srvkit", "ui", "webkit"]);
+const BARREL_FACETS = new Set(["common", "srvkit", "ui", "webkit", "plugin"]);
 const FACET_SOURCE_FILE_RE = /\.(ts|tsx)$/;
 const FACET_EXCLUDED_FILE_RE = /(^index\.tsx?$|\.d\.ts$|\.(test|spec)\.(ts|tsx)$|\.css$|\.scss$|\.sass$)/;
 // `ui` exports PascalCase names only; `common`/`srvkit`/`webkit` export camelCase names only. Names with

package/index.ts

@@ -18,7 +18,6 @@ export * from "./dependencyScanner";
 export * from "./executors";
 export * from "./extractDeps";
 export * from "./fileSys";
-export * from "./firebaseMessagingSw";
 export * from "./frontendBuild";
 export * from "./getCredentials";
 export * from "./getDirname";

package/package.json

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

package/qualityScanner.ts

@@ -74,7 +74,7 @@ const SUGGESTED_RULES = [
   "Dictionary text should not contain scaffold wording, misspellings, or stale copied domain nouns.",
   "Warn earlier on very long Akan files: 500 lines for services, 800 lines for Template/Zone files, and 1000 lines for Util files.",
   "Global declarations, Window augmentation, and prototype mutation should stay in explicitly approved low-level integration files.",
-  "Keep app root folders small and conventional: application code belongs under common, env, lib, page, private, public, script, srvkit, ui, or webkit.",
+  "Keep app root folders small and conventional: application code belongs under common, env, lib, page, plugin, private, public, script, srvkit, ui, or webkit.",
   "Keep apps/*/lib and libs/*/lib root files limited to generated support facets such as cnst.ts, db.ts, dict.ts, sig.ts, srv.ts, st.ts, useClient.ts, and useServer.ts.",
   "Use domain module folders consistently: lib/<model> for database modules, lib/_<service> for service modules, and lib/__scalar/<scalar> for scalar modules.",
   "Keep module UI filenames predictable: database modules use <Model>.Template/Unit/Util/View/Zone.tsx, service modules use <Service>.Util/Zone.tsx, and scalar modules use <Scalar>.Template/Unit.tsx.",

package/firebaseMessagingSw.test.ts

@@ -1,66 +0,0 @@
-import { describe, expect, test } from "bun:test";
-import {
-  createFirebaseMessagingServiceWorker,
-  normalizeFirebaseClientConfig,
-} from "./firebaseMessagingSw";
-
-describe("normalizeFirebaseClientConfig", () => {
-  test("whitelists client fields and drops secrets / vapidKey", () => {
-    const normalized = normalizeFirebaseClientConfig({
-      apiKey: "public-api-key",
-      authDomain: "example.firebaseapp.com",
-      projectId: "public-project",
-      storageBucket: "public-project.appspot.com",
-      messagingSenderId: "1234567890",
-      appId: "public-app-id",
-      vapidKey: "public-vapid-key",
-      private_key: "SERVER_PRIVATE_KEY_MUST_NOT_LEAK",
-    });
-    expect(normalized).toEqual({
-      apiKey: "public-api-key",
-      authDomain: "example.firebaseapp.com",
-      projectId: "public-project",
-      storageBucket: "public-project.appspot.com",
-      messagingSenderId: "1234567890",
-      appId: "public-app-id",
-    });
-    expect(normalized).not.toHaveProperty("vapidKey");
-    expect(normalized).not.toHaveProperty("private_key");
-  });
-
-  test("returns null when required fields are missing or input is not an object", () => {
-    expect(normalizeFirebaseClientConfig(undefined)).toBe(null);
-    expect(normalizeFirebaseClientConfig(null)).toBe(null);
-    expect(normalizeFirebaseClientConfig("nope")).toBe(null);
-    expect(normalizeFirebaseClientConfig({ apiKey: "only-key" })).toBe(null);
-  });
-});
-
-describe("createFirebaseMessagingServiceWorker", () => {
-  test("inlines client config and imports firebase compat SDK, without leaking secrets", () => {
-    const config = normalizeFirebaseClientConfig({
-      apiKey: "public-api-key",
-      projectId: "public-project",
-      messagingSenderId: "1234567890",
-      appId: "public-app-id",
-      private_key: "SERVER_PRIVATE_KEY_MUST_NOT_LEAK",
-    });
-    const body = createFirebaseMessagingServiceWorker(config);
-    expect(body).toContain("public-api-key");
-    expect(body).toContain("public-project");
-    expect(body).toContain("firebase-messaging-compat.js");
-    expect(body).toContain("onBackgroundMessage");
-    expect(body).toContain("notificationclick");
-    expect(body).not.toContain("SERVER_PRIVATE_KEY_MUST_NOT_LEAK");
-    expect(body).not.toContain("private_key");
-  });
-
-  test("produces a no-op worker (config null) that still registers notificationclick", () => {
-    const body = createFirebaseMessagingServiceWorker(null);
-    // config is null → the importScripts/onBackgroundMessage block is gated by `if (firebaseConfig)` at runtime,
-    // but notificationclick is always registered.
-    expect(body).toContain("const firebaseConfig = null");
-    expect(body).toContain("notificationclick");
-    expect(body).toContain("if (firebaseConfig)");
-  });
-});

package/firebaseMessagingSw.ts

@@ -1,74 +0,0 @@
- const FIREBASE_WEB_SDK_VERSION = "12.13.0";
-
-export interface FirebaseClientEnvConfig {
-  apiKey: string;
-  authDomain?: string;
-  projectId: string;
-  storageBucket?: string;
-  messagingSenderId: string;
-  appId: string;
-  vapidKey?: string;
-}
-
-//* env.client 의 firebase 설정을 검증하고, 서비스워커에 필요한 필드만 화이트리스트한다.
-//* vapidKey/서버 시크릿 등 나머지 필드는 의도적으로 제외한다(SW 본문에 유출 방지).
-export function normalizeFirebaseClientConfig(config: unknown): FirebaseClientEnvConfig | null {
-  if (!config || typeof config !== "object") return null;
-  const value = config as Partial<Record<keyof FirebaseClientEnvConfig, unknown>>;
-  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,
-  };
-}
-
-//* firebase-messaging-sw.js 생성 코드
-export function createFirebaseMessagingServiceWorker(config: FirebaseClientEnvConfig | null): string {
-  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));
-});
-`;
-}