@akanjs/devkit 2.1.0-rc.9 → 2.1.0

package/akanConfig/akanConfig.test.ts

@@ -132,6 +132,7 @@ describe("AkanAppConfig", () => {
         react: "19.0.0",
         "react-dom": "19.0.0",
         "react-server-dom-webpack": "19.0.0",
+        croner: akanPackageJson.peerDependencies?.croner,
         sharp: "1.0.0",
         "@external/runtime": "2.0.0",
       },
@@ -168,10 +169,45 @@ describe("AkanAppConfig", () => {
       react: runtimeDependencies.react,
       "react-dom": runtimeDependencies["react-dom"],
       "react-server-dom-webpack": runtimeDependencies["react-server-dom-webpack"],
+      croner: runtimeDependencies.croner,
       sharp: runtimeDependencies.sharp,
     });
   });
 
+  test("adds backend runtime packages by database mode", () => {
+    const runtimeDependencies = { ...akanPackageJson.dependencies, ...akanPackageJson.peerDependencies };
+    const singleConfig = new AkanAppConfig(app, [], packageJson, { defaultDatabaseMode: "single" }, baseDevEnv);
+    const multipleConfig = new AkanAppConfig(app, [], packageJson, { defaultDatabaseMode: "multiple" }, baseDevEnv);
+    const clusterConfig = new AkanAppConfig(app, [], packageJson, { defaultDatabaseMode: "cluster" }, baseDevEnv);
+
+    expect(singleConfig.getProductionPackageJson().dependencies).toMatchObject({
+      croner: runtimeDependencies.croner,
+    });
+    expect(singleConfig.getProductionPackageJson().dependencies).not.toHaveProperty("ioredis");
+    expect(singleConfig.getProductionPackageJson().dependencies).not.toHaveProperty("bullmq");
+    expect(singleConfig.getProductionPackageJson().dependencies).not.toHaveProperty("@libsql/client");
+    expect(singleConfig.getProductionPackageJson().dependencies).not.toHaveProperty("postgres");
+    expect(singleConfig.getProductionPackageJson().dependencies).not.toHaveProperty("protobufjs");
+
+    expect(multipleConfig.getProductionPackageJson().dependencies).toMatchObject({
+      "@libsql/client": runtimeDependencies["@libsql/client"],
+      bullmq: runtimeDependencies.bullmq,
+      croner: runtimeDependencies.croner,
+      ioredis: runtimeDependencies.ioredis,
+      protobufjs: runtimeDependencies.protobufjs,
+    });
+    expect(multipleConfig.getProductionPackageJson().dependencies).not.toHaveProperty("postgres");
+
+    expect(clusterConfig.getProductionPackageJson().dependencies).toMatchObject({
+      bullmq: runtimeDependencies.bullmq,
+      croner: runtimeDependencies.croner,
+      ioredis: runtimeDependencies.ioredis,
+      postgres: runtimeDependencies.postgres,
+      protobufjs: runtimeDependencies.protobufjs,
+    });
+    expect(clusterConfig.getProductionPackageJson().dependencies).not.toHaveProperty("@libsql/client");
+  });
+
   test("normalizes multiple mobile targets and validates base paths", () => {
     const config = new AkanAppConfig(
       app,

package/akanConfig/akanConfig.ts

@@ -50,7 +50,18 @@ const DEFAULT_OPTIMIZE_IMPORTS = [
 const WORKSPACE_BARREL_FACETS = ["ui", "webkit", "common", "client", "server"] as const;
 const SSR_RUNTIME_PACKAGES = ["react", "react-dom", "react-server-dom-webpack"] as const;
 const NATIVE_RUNTIME_PACKAGES = ["sharp"] as const;
-const AKAN_RUNTIME_PACKAGES = new Set<string>([...SSR_RUNTIME_PACKAGES, ...NATIVE_RUNTIME_PACKAGES]);
+const DEFAULT_BACKEND_RUNTIME_PACKAGES = ["croner"] as const;
+const DATABASE_MODE_RUNTIME_PACKAGES = {
+  single: [],
+  multiple: ["@libsql/client", "bullmq", "ioredis", "protobufjs"],
+  cluster: ["bullmq", "ioredis", "postgres", "protobufjs"],
+} satisfies Record<DatabaseMode, readonly string[]>;
+const AKAN_RUNTIME_PACKAGES = new Set<string>([
+  ...SSR_RUNTIME_PACKAGES,
+  ...NATIVE_RUNTIME_PACKAGES,
+  ...DEFAULT_BACKEND_RUNTIME_PACKAGES,
+  ...Object.values(DATABASE_MODE_RUNTIME_PACKAGES).flat(),
+]);
 const DEFAULT_AKAN_IMAGE_CONFIG: AkanImageConfig = {
   deviceSizes: [640, 750, 828, 1080, 1200, 1920, 2048, 3840],
   imageSizes: [32, 48, 64, 96, 128, 256, 384],
@@ -272,6 +283,15 @@ CMD [${command.map((c) => `"${c}"`).join(",")}]`;
     if (AKAN_RUNTIME_PACKAGES.has(lib))
       return akanPackageJson.dependencies?.[lib] ?? akanPackageJson.peerDependencies?.[lib];
   }
+  #getProductionRuntimePackages() {
+    return [
+      ...this.externalLibs,
+      ...SSR_RUNTIME_PACKAGES,
+      ...NATIVE_RUNTIME_PACKAGES,
+      ...DEFAULT_BACKEND_RUNTIME_PACKAGES,
+      ...DATABASE_MODE_RUNTIME_PACKAGES[this.defaultDatabaseMode],
+    ];
+  }
   getProductionPackageJson(data: Partial<PackageJson> = {}): PackageJson {
     return {
       name: this.app.name,
@@ -279,7 +299,7 @@ CMD [${command.map((c) => `"${c}"`).join(",")}]`;
       version: "1.0.0",
       main: "./main.js",
       dependencies: Object.fromEntries(
-        [...new Set([...this.externalLibs, ...SSR_RUNTIME_PACKAGES, ...NATIVE_RUNTIME_PACKAGES])].map((lib) => {
+        [...new Set(this.#getProductionRuntimePackages())].map((lib) => {
           const version = this.#resolveProductionDependencyVersion(lib);
           if (!version) throw new Error(`Dependency ${lib} not found in package.json`);
           return [lib, version];

package/applicationBuildRunner.test.ts

@@ -0,0 +1,10 @@
+import { describe, expect, test } from "bun:test";
+import { AKAN_OPTIONAL_BACKEND_EXTERNALS } from "./applicationBuildRunner";
+
+describe("ApplicationBuildRunner", () => {
+  test("externalizes Akan optional backend dependencies", () => {
+    expect(AKAN_OPTIONAL_BACKEND_EXTERNALS).toEqual(
+      expect.arrayContaining(["@libsql/client", "bullmq", "croner", "ioredis", "postgres", "protobufjs"]),
+    );
+  });
+});

package/applicationBuildRunner.ts

@@ -47,10 +47,21 @@ const SSR_RENDER_EXTERNALS = [
   "react/jsx-dev-runtime",
   "react-dom",
   "react-dom/server.browser",
+  "react-server-dom-webpack",
+  "react-server-dom-webpack/server.node",
   "react-server-dom-webpack/client.node",
   "react-server-dom-webpack/client.browser",
 ] as const;
 
+export const AKAN_OPTIONAL_BACKEND_EXTERNALS = [
+  "@libsql/client",
+  "bullmq",
+  "croner",
+  "ioredis",
+  "postgres",
+  "protobufjs",
+] as const;
+
 export class ApplicationBuildRunner {
   #app: App;
   #fast: boolean;
@@ -161,7 +172,9 @@ export class ApplicationBuildRunner {
 
   async #buildBackend() {
     const akanConfig = await this.#app.getConfig();
-    const backendExternals = [...new Set([...akanConfig.externalLibs, ...SSR_RENDER_EXTERNALS])];
+    const backendExternals = [
+      ...new Set([...akanConfig.externalLibs, ...SSR_RENDER_EXTERNALS, ...AKAN_OPTIONAL_BACKEND_EXTERNALS]),
+    ];
     const backendEntryPoints = [`${this.#app.cwdPath}/main.ts`, `${this.#app.cwdPath}/server.ts`];
     for (const entrypoint of backendEntryPoints) {
       if (!(await Bun.file(entrypoint).exists())) throw new Error(`Backend entrypoint not found: ${entrypoint}`);
@@ -183,8 +196,7 @@ export class ApplicationBuildRunner {
       conditions: ["react-server"],
       // `akan build` must embed production react-server-dom regardless of the shell's NODE_ENV.
       define: { "process.env.NODE_ENV": JSON.stringify("production") },
-      plugins:
-        akanConfig.externalLibs.length > 0 ? [this.#createExternalSpecifiersPlugin(akanConfig.externalLibs)] : [],
+      plugins: backendExternals.length > 0 ? [this.#createExternalSpecifiersPlugin(backendExternals)] : [],
     });
     return {
       entrypoints: backendEntryPoints.length + 1,

package/applicationTestPreload.ts

@@ -0,0 +1,40 @@
+import path from "node:path";
+
+export const SIGNAL_TEST_PRELOAD_PATH = "test/signalTest.preload.ts";
+
+export interface SignalTestPreloadTarget {
+  cwdPath: string;
+}
+
+export async function resolveSignalTestPreloadPath(target: SignalTestPreloadTarget) {
+  const candidates: string[] = [];
+  const addResolvedPackageCandidate = (basePath: string) => {
+    try {
+      candidates.push(
+        path.join(path.dirname(Bun.resolveSync("akanjs/package.json", basePath)), SIGNAL_TEST_PRELOAD_PATH),
+      );
+    } catch {
+      // Source workspaces and published installs can resolve Akan packages from different roots.
+    }
+  };
+
+  addResolvedPackageCandidate(target.cwdPath);
+  addResolvedPackageCandidate(process.cwd());
+  addResolvedPackageCandidate(path.dirname(Bun.main));
+  addResolvedPackageCandidate(import.meta.dir);
+
+  candidates.push(
+    path.join(target.cwdPath, "../../node_modules/akanjs", SIGNAL_TEST_PRELOAD_PATH),
+    path.join(target.cwdPath, "../../pkgs/akanjs", SIGNAL_TEST_PRELOAD_PATH),
+    path.join(process.cwd(), "node_modules/akanjs", SIGNAL_TEST_PRELOAD_PATH),
+    path.join(process.cwd(), "pkgs/akanjs", SIGNAL_TEST_PRELOAD_PATH),
+    path.join(path.dirname(Bun.main), "../../akanjs", SIGNAL_TEST_PRELOAD_PATH),
+    path.resolve(import.meta.dir, "../../akanjs", SIGNAL_TEST_PRELOAD_PATH),
+  );
+
+  for (const candidate of [...new Set(candidates)]) {
+    if (await Bun.file(candidate).exists()) return candidate;
+  }
+
+  throw new Error(`Failed to locate ${SIGNAL_TEST_PRELOAD_PATH} from ${target.cwdPath}`);
+}

package/devkitUtils.test.ts

@@ -3,6 +3,7 @@ import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
 import { ApplicationBuildReporter } from "./applicationBuildReporter";
+import { resolveSignalTestPreloadPath } from "./applicationTestPreload";
 import { TypeScriptDependencyScanner } from "./dependencyScanner";
 import { extractDependencies } from "./extractDeps";
 import { getModelFileData } from "./getModelFileData";
@@ -84,6 +85,26 @@ describe("extractDependencies", () => {
   });
 });
 
+describe("resolveSignalTestPreloadPath", () => {
+  test("resolves the preload file from an installed akanjs package", async () => {
+    const root = await makeTempRoot();
+    const libDir = path.join(root, "libs/shared");
+    await write(
+      path.join(root, "node_modules/akanjs/package.json"),
+      JSON.stringify({
+        name: "akanjs",
+        version: "0.0.0",
+        exports: { "./package.json": "./package.json" },
+      }),
+    );
+    await write(path.join(root, "node_modules/akanjs/test/signalTest.preload.ts"), "export {};\n");
+
+    await expect(resolveSignalTestPreloadPath({ cwdPath: libDir })).resolves.toContain(
+      "node_modules/akanjs/test/signalTest.preload.ts",
+    );
+  });
+});
+
 describe("TypeScriptDependencyScanner", () => {
   test("separates monorepo package, lib, runtime, and type-only dependencies", async () => {
     const root = await makeTempRoot();

package/index.ts

@@ -4,6 +4,7 @@ export * from "./akanConfig";
 export * from "./applicationBuildReporter";
 export * from "./applicationBuildRunner";
 export * from "./applicationReleasePackager";
+export * from "./applicationTestPreload";
 export * from "./artifact";
 export * from "./auth";
 export * from "./builder";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/devkit",
-  "version": "2.1.0-rc.9",
+  "version": "2.1.0",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {
@@ -31,7 +31,7 @@
     "@langchain/deepseek": "^1.0.26",
     "@langchain/openai": "^1.4.6",
     "@trapezedev/project": "^7.1.4",
-    "akanjs": "2.1.0-rc.8",
+    "akanjs": "2.1.0",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "daisyui": "^5.5.20",