@akanjs/devkit 2.3.11 → 2.3.12-rc.1

package/akanConfig/akanConfig.test.ts

@@ -264,6 +264,8 @@ describe("AkanAppConfig", () => {
       `postgres@${runtimeDependencies.postgres}`,
       `protobufjs@${runtimeDependencies.protobufjs}`,
     ]);
+    expect(config.getMobileRuntimePackages()).toEqual(["firebase"]);
+    expect(config.getMissingMobileDependencySpecs()).toEqual([`firebase@${runtimeDependencies.firebase}`]);
   });
 
   test("normalizes multiple mobile targets and validates base paths", () => {

package/akanConfig/akanConfig.ts

@@ -51,6 +51,9 @@ const WORKSPACE_BARREL_FACETS = ["ui", "webkit", "common", "client", "server"] a
 const SSR_RUNTIME_PACKAGES = ["react", "react-dom", "react-server-dom-webpack"] as const;
 const NATIVE_RUNTIME_PACKAGES = ["sharp"] as const;
 const DEFAULT_BACKEND_RUNTIME_PACKAGES = ["croner"] as const;
+// Native-only client packages that are not bundled into the base bootstrap; installed
+// on demand when a mobile target is built or started (e.g. firebase for push tokens).
+const MOBILE_RUNTIME_PACKAGES = ["firebase"] as const;
 const DATABASE_MODE_RUNTIME_PACKAGES = {
   single: [],
   multiple: ["@libsql/client", "bullmq", "ioredis", "protobufjs"],
@@ -60,6 +63,7 @@ const AKAN_RUNTIME_PACKAGES = new Set<string>([
   ...SSR_RUNTIME_PACKAGES,
   ...NATIVE_RUNTIME_PACKAGES,
   ...DEFAULT_BACKEND_RUNTIME_PACKAGES,
+  ...MOBILE_RUNTIME_PACKAGES,
   ...Object.values(DATABASE_MODE_RUNTIME_PACKAGES).flat(),
 ]);
 const DEFAULT_AKAN_IMAGE_CONFIG: AkanImageConfig = {
@@ -360,11 +364,20 @@ CMD [${command.map((c) => `"${c}"`).join(",")}]`;
     return [...DATABASE_MODE_RUNTIME_PACKAGES[databaseMode]];
   }
   getMissingDatabaseModeDependencySpecs(databaseMode: DatabaseMode = this.defaultDatabaseMode) {
+    return this.#getMissingDependencySpecs(this.getDatabaseModeRuntimePackages(databaseMode));
+  }
+  getMobileRuntimePackages() {
+    return [...MOBILE_RUNTIME_PACKAGES];
+  }
+  getMissingMobileDependencySpecs() {
+    return this.#getMissingDependencySpecs(this.getMobileRuntimePackages());
+  }
+  #getMissingDependencySpecs(libs: readonly string[]) {
     const rootDependencies = {
       ...this.rootPackageJson.dependencies,
       ...this.rootPackageJson.devDependencies,
     };
-    return this.getDatabaseModeRuntimePackages(databaseMode)
+    return libs
       .filter((lib) => !rootDependencies[lib])
       .map((lib) => {
         const version = this.#resolveProductionDependencyVersion(lib);

package/frontendBuild/devGeneratedIndexSync.test.ts

@@ -0,0 +1,66 @@
+import { afterEach, describe, expect, test } from "bun:test";
+import { mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { DevGeneratedIndexSync } from "./devGeneratedIndexSync";
+
+const tempRoots: string[] = [];
+
+const makeTempRoot = async () => {
+  const root = await mkdtemp(path.join(os.tmpdir(), "akan-generated-index-"));
+  tempRoots.push(root);
+  return root;
+};
+
+const seedFacet = async (root: string, facet: string, { files, dirs }: { files: string[]; dirs: string[] }) => {
+  const dir = path.join(root, "libs", "util", facet);
+  await mkdir(dir, { recursive: true });
+  await Promise.all(files.map((name) => writeFile(path.join(dir, name), "export const x = 1;\n")));
+  await Promise.all(dirs.map((name) => mkdir(path.join(dir, name), { recursive: true })));
+  return dir;
+};
+
+const barrelFor = async (root: string, facet: string, seed: { files: string[]; dirs: string[]; trigger: string }) => {
+  const dir = await seedFacet(root, facet, seed);
+  const sync = new DevGeneratedIndexSync({ workspaceRoot: root });
+  const result = await sync.syncForBatch([path.join(dir, seed.trigger)]);
+  expect(result.errors).toEqual([]);
+  return readFile(path.join(dir, "index.ts"), "utf8");
+};
+
+afterEach(async () => {
+  await Promise.all(tempRoots.splice(0).map((root) => rm(root, { recursive: true, force: true })));
+});
+
+describe("DevGeneratedIndexSync facet barrels", () => {
+  test("camelCase facets export only clean camelCase names", async () => {
+    const content = await barrelFor(await makeTempRoot(), "srvkit", {
+      files: [
+        "aes.ts",
+        "cloudflareApi.ts",
+        "cloudflareApi.helper.ts", // dotted → skipped
+        "pushNotificationServer.type.ts", // dotted → skipped
+        "PushNotificationServer.ts", // PascalCase in camel facet → skipped
+        "my_snake.ts", // snake_case → skipped
+        "kebab-case.ts", // kebab-case → skipped
+      ],
+      dirs: ["storageApi", "BadDir"], // PascalCase dir → skipped
+      trigger: "aes.ts",
+    });
+    expect(content).toBe(`export * from "./aes";\nexport * from "./cloudflareApi";\nexport * from "./storageApi";\n`);
+  });
+
+  test("ui facet exports only clean PascalCase names", async () => {
+    const content = await barrelFor(await makeTempRoot(), "ui", {
+      files: [
+        "Globe.tsx",
+        "AkanLogo.tsx",
+        "Globe_Dynamic.tsx", // underscore → skipped
+        "lowerStart.tsx", // camelCase in ui facet → skipped
+      ],
+      dirs: ["Code", "badDir"], // camelCase dir → skipped
+      trigger: "Globe.tsx",
+    });
+    expect(content).toBe(`export * from "./AkanLogo";\nexport * from "./Code";\nexport * from "./Globe";\n`);
+  });
+});

package/frontendBuild/devGeneratedIndexSync.ts

@@ -4,6 +4,10 @@ import path from "node:path";
 const BARREL_FACETS = new Set(["common", "srvkit", "ui", "webkit"]);
 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
+// dots, underscores, or hyphens (e.g. `foo.helper`, `Globe_Dynamic`, `kebab-case`) match neither and are skipped.
+const FACET_PASCAL_CASE_RE = /^[A-Z][A-Za-z0-9]*$/;
+const FACET_CAMEL_CASE_RE = /^[a-z][A-Za-z0-9]*$/;
 const MODULE_UI_TYPES = ["Template", "Unit", "Util", "View", "Zone"] as const;
 const SERVICE_UI_TYPES = ["Util", "Zone"] as const;
 const SCALAR_UI_TYPES = ["Template", "Unit"] as const;
@@ -109,15 +113,17 @@ export class DevGeneratedIndexSync {
   }
 
   async #facetContent(dir: string): Promise<string | null> {
+    const nameCasePattern = path.basename(dir) === "ui" ? FACET_PASCAL_CASE_RE : FACET_CAMEL_CASE_RE;
     const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
     const exportNames = entries
       .flatMap((entry) => {
         const name = entry.name;
         if (name.startsWith(".")) return [];
-        if (entry.isDirectory()) return [name];
+        if (entry.isDirectory()) return nameCasePattern.test(name) ? [name] : [];
         if (!entry.isFile()) return [];
         if (!FACET_SOURCE_FILE_RE.test(name) || FACET_EXCLUDED_FILE_RE.test(name)) return [];
-        return [name.replace(FACET_SOURCE_FILE_RE, "")];
+        const exportName = name.replace(FACET_SOURCE_FILE_RE, "");
+        return nameCasePattern.test(exportName) ? [exportName] : [];
       })
       .sort();
     if (exportNames.length === 0) return null;

package/package.json

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