@akanjs/cli 2.1.1 → 2.1.2-rc.0

package/index.js

@@ -203,11 +203,13 @@ class HttpClient {
 class CloudApi {
   #api;
   #accessToken = null;
-  static async fromHost(host) {
+  #workspace;
+  static async fromHost(workspace, host) {
     const hostConfig = await GlobalConfig.getHostConfig(host);
-    return new CloudApi(hostConfig);
+    return new CloudApi(workspace, hostConfig);
   }
-  constructor(hostConfig) {
+  constructor(workspace, hostConfig) {
+    this.#workspace = workspace;
     const host = akanCloudHost;
     this.#api = new HttpClient(`${host}/api`);
     this.#accessToken = hostConfig.auth?.accessToken ?? null;
@@ -223,16 +225,17 @@ class CloudApi {
     const data = await this.#api.post(`/uploadEnv/${devProjectId}`, formData);
     return data;
   }
-  async downloadEnv(devProjectId, localPath) {
+  async downloadEnv(devProjectId) {
+    const localPath = `${this.#workspace.workspaceRoot}/local/env.tar`;
     await this.#api.getFile(`/downloadEnv/${devProjectId}`, localPath);
   }
   async getRemoteAuthToken(remoteId) {
     try {
       if (this.#accessToken) {
         if (GlobalConfig.needRefreshToken(this.#accessToken))
-          return await this.refreshAuthToken();
+          return await this.#refreshAuthToken();
         else
-          return await this.refreshAuthToken();
+          return await this.#refreshAuthToken();
       }
       const accessToken = await this.#api.get(`/getRemoteAuthToken/${remoteId}`);
       this.#accessToken = GlobalConfig.toAccessToken(accessToken);
@@ -244,10 +247,14 @@ class CloudApi {
       return null;
     }
   }
-  async refreshAuthToken() {
-    const response = await this.#api.post(`/refreshRemoteAuthToken`, {
-      refreshToken: this.#accessToken?.refreshToken
-    });
+  async#refreshAuthToken() {
+    const refreshToken = this.#accessToken?.refreshToken;
+    if (!refreshToken)
+      throw new Error("No refresh token");
+    return await this.refreshAuthToken(refreshToken);
+  }
+  async refreshAuthToken(refreshToken) {
+    const response = await this.#api.post(`/refreshRemoteAuthToken`, { refreshToken });
     this.#accessToken = GlobalConfig.toAccessToken(response);
     this.#api.setHeaders({ Authorization: `Bearer ${this.#accessToken.jwt}` });
     return this.#accessToken;
@@ -650,12 +657,7 @@ import {
   spawn as spawn2
 } from "child_process";
 import { readFileSync as readFileSync3 } from "fs";
-import {
-  copyFile,
-  mkdir as mkdir2,
-  readdir as readDirEntries,
-  stat as stat2
-} from "fs/promises";
+import { copyFile, mkdir as mkdir2, readdir as readDirEntries, stat as stat2 } from "fs/promises";
 import path7 from "path";
 import {
   capitalize,
@@ -707,8 +709,18 @@ var DEFAULT_OPTIMIZE_IMPORTS = [
   "mui-core",
   "react-icons/*"
 ];
-var WORKSPACE_BARREL_FACETS = ["ui", "webkit", "common", "client", "server"];
-var SSR_RUNTIME_PACKAGES = ["react", "react-dom", "react-server-dom-webpack"];
+var WORKSPACE_BARREL_FACETS = [
+  "ui",
+  "webkit",
+  "common",
+  "client",
+  "server"
+];
+var SSR_RUNTIME_PACKAGES = [
+  "react",
+  "react-dom",
+  "react-server-dom-webpack"
+];
 var NATIVE_RUNTIME_PACKAGES = ["sharp"];
 var DEFAULT_BACKEND_RUNTIME_PACKAGES = ["croner"];
 var DATABASE_MODE_RUNTIME_PACKAGES = {
@@ -768,7 +780,12 @@ class AkanAppConfig {
       ...libs.flatMap((lib) => WORKSPACE_BARREL_FACETS.map((facet) => `@libs/${lib}/${facet}`)),
       ...config?.barrelImports ?? []
     ];
-    this.optimizeImports = [...new Set([...DEFAULT_OPTIMIZE_IMPORTS, ...config?.optimizeImports ?? []])];
+    this.optimizeImports = [
+      ...new Set([
+        ...DEFAULT_OPTIMIZE_IMPORTS,
+        ...config?.optimizeImports ?? []
+      ])
+    ];
     this.images = mergeImageConfig(config?.images);
     this.i18n = resolveAkanI18nConfig(config?.i18n);
     process.env.AKAN_PUBLIC_DEFAULT_LOCALE = this.i18n.defaultLocale;
@@ -879,7 +896,13 @@ class AkanAppConfig {
   }
   #makeDockerContent(docker) {
     if (docker.content)
-      return { content: docker.content, image: {}, preRuns: [], postRuns: [], command: [] };
+      return {
+        content: docker.content,
+        image: {},
+        preRuns: [],
+        postRuns: [],
+        command: []
+      };
     const preRunScripts = this.#getDockerRunScripts(docker.preRuns ?? []);
     const postRunScripts = this.#getDockerRunScripts(docker.postRuns ?? []);
     const imageScript = docker.image ? this.#getDockerImageScript(docker.image, "oven/bun:1-slim") : "FROM oven/bun:1-slim";
@@ -910,7 +933,13 @@ ENV AKAN_PUBLIC_LOCALES=${this.i18n.locales.join(",")}
 ENV AKAN_PUBLIC_OPERATION_MODE=cloud
 
 CMD [${command.map((c) => `"${c}"`).join(",")}]`;
-    return { content, image: imageScript, preRuns: docker.preRuns ?? [], postRuns: docker.postRuns ?? [], command };
+    return {
+      content,
+      image: imageScript,
+      preRuns: docker.preRuns ?? [],
+      postRuns: docker.postRuns ?? [],
+      command
+    };
   }
   static async from(app) {
     const [configImp, baseDevEnv, libs, rootPackageJson] = await Promise.all([
@@ -936,9 +965,24 @@ CMD [${command.map((c) => `"${c}"`).join(",")}]`;
       ...SSR_RUNTIME_PACKAGES,
       ...NATIVE_RUNTIME_PACKAGES,
       ...DEFAULT_BACKEND_RUNTIME_PACKAGES,
-      ...DATABASE_MODE_RUNTIME_PACKAGES[this.defaultDatabaseMode]
+      ...this.getDatabaseModeRuntimePackages()
     ];
   }
+  getDatabaseModeRuntimePackages(databaseMode = this.defaultDatabaseMode) {
+    return [...DATABASE_MODE_RUNTIME_PACKAGES[databaseMode]];
+  }
+  getMissingDatabaseModeDependencySpecs(databaseMode = this.defaultDatabaseMode) {
+    const rootDependencies = {
+      ...this.rootPackageJson.dependencies,
+      ...this.rootPackageJson.devDependencies
+    };
+    return this.getDatabaseModeRuntimePackages(databaseMode).filter((lib) => !rootDependencies[lib]).map((lib) => {
+      const version = this.#resolveProductionDependencyVersion(lib);
+      if (!version)
+        throw new Error(`Dependency ${lib} not found in package.json`);
+      return `${lib}@${version}`;
+    });
+  }
   getProductionPackageJson(data = {}) {
     return {
       name: this.app.name,
@@ -974,7 +1018,12 @@ function getAkanPackageJson() {
       return akanPackageJson;
     } catch {}
   }
-  akanPackageJson = { name: "akanjs", version: "0.0.0", description: "akanjs", dependencies: {} };
+  akanPackageJson = {
+    name: "akanjs",
+    version: "0.0.0",
+    description: "akanjs",
+    dependencies: {}
+  };
   return akanPackageJson;
 }
 function mergeImageConfig(config = {}) {
@@ -998,7 +1047,9 @@ class AkanLibConfig {
     this.externalLibs = config?.externalLibs ?? [];
   }
   static async from(lib) {
-    const [configImp] = await Promise.all([import(`${lib.cwdPath}/akan.config.ts`).then((mod) => mod.default)]);
+    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);
   }
@@ -2372,13 +2423,8 @@ class CommandExecutionError extends Error {
     const displayCommand = formatCommandForDisplay(command, args);
     const status = signal ? `signal: ${signal}` : `exit code: ${code ?? "unknown"}`;
     const output = (stderr || stdout).trim();
-    super([
-      `Command failed: ${displayCommand}`,
-      `cwd: ${cwd}`,
-      status,
-      output ? `
-${output}` : ""
-    ].join(`
+    super([`Command failed: ${displayCommand}`, `cwd: ${cwd}`, status, output ? `
+${output}` : ""].join(`
 `), {
       cause
     });
@@ -2427,13 +2473,7 @@ var parseEnvFile = (envPath) => {
   }
   return env;
 };
-var PAGE_ROUTE_EXPORTS = new Set([
-  "default",
-  "pageConfig",
-  "head",
-  "generateHead",
-  "Loading"
-]);
+var PAGE_ROUTE_EXPORTS = new Set(["default", "pageConfig", "head", "generateHead", "Loading"]);
 var ROOT_LAYOUT_EXPORTS = new Set([
   "default",
   "head",
@@ -2444,14 +2484,11 @@ var ROOT_LAYOUT_EXPORTS = new Set([
   "reconnect",
   "layoutStyle",
   "gaTrackingId",
-  "Loading"
-]);
-var LAYOUT_ROUTE_EXPORTS = new Set([
-  "default",
-  "head",
-  "generateHead",
-  "Loading"
+  "Loading",
+  "NotFound",
+  "Error"
 ]);
+var LAYOUT_ROUTE_EXPORTS = new Set(["default", "head", "generateHead", "Loading", "NotFound", "Error"]);
 function validateRouteSourceExports(source, filePath, kind, options = {}) {
   const sourceFile = ts3.createSourceFile(filePath, source, ts3.ScriptTarget.Latest, true, ts3.ScriptKind.TSX);
   const allowed = kind === "page" ? PAGE_ROUTE_EXPORTS : options.rootLayout ? ROOT_LAYOUT_EXPORTS : LAYOUT_ROUTE_EXPORTS;
@@ -2798,11 +2835,7 @@ class Executor {
     this.logger.debug(msg);
     return this;
   }
-  spinning(msg, {
-    prefix = `${this.emoji}${this.name}`,
-    indent = 0,
-    enableSpin = !Executor.verbose
-  } = {}) {
+  spinning(msg, { prefix = `${this.emoji}${this.name}`, indent = 0, enableSpin = !Executor.verbose } = {}) {
     return new Spinner(msg, { prefix, indent, enableSpin }).start();
   }
   #tsconfig = null;
@@ -2831,9 +2864,7 @@ class Executor {
     this.#tsconfig = tsconfig;
   }
   #packageJson = null;
-  async getPackageJson({
-    refresh
-  } = {}) {
+  async getPackageJson({ refresh } = {}) {
     if (this.#packageJson && !refresh)
       return this.#packageJson;
     const packageJson = await this.readJson("package.json");
@@ -2949,10 +2980,7 @@ class Executor {
   async applyTemplate(options) {
     const dict = {
       ...options.dict ?? {},
-      ...Object.fromEntries(Object.entries(options.dict ?? {}).map(([key, value]) => [
-        capitalize(key),
-        capitalize(value)
-      ]))
+      ...Object.fromEntries(Object.entries(options.dict ?? {}).map(([key, value]) => [capitalize(key), capitalize(value)]))
     };
     return this._applyTemplate({ ...options, dict });
   }
@@ -3088,10 +3116,7 @@ class WorkspaceExecutor extends Executor {
     return await this.#getDirHasFile(`${this.workspaceRoot}/libs`, "akan.config.ts");
   }
   async getSyss() {
-    const [appNames, libNames] = await Promise.all([
-      this.getApps(),
-      this.getLibs()
-    ]);
+    const [appNames, libNames] = await Promise.all([this.getApps(), this.getLibs()]);
     return [appNames, libNames];
   }
   async getPkgs() {
@@ -3100,11 +3125,7 @@ class WorkspaceExecutor extends Executor {
     return await this.#getDirHasFile(`${this.workspaceRoot}/pkgs`, "package.json");
   }
   async getExecs() {
-    const [appNames, libNames, pkgNames] = await Promise.all([
-      this.getApps(),
-      this.getLibs(),
-      this.getPkgs()
-    ]);
+    const [appNames, libNames, pkgNames] = await Promise.all([this.getApps(), this.getLibs(), this.getPkgs()]);
     return [appNames, libNames, pkgNames];
   }
   async setPkgTsPaths(name) {
@@ -3122,10 +3143,7 @@ class WorkspaceExecutor extends Executor {
   async unsetPkgTsPaths(name) {
     const rootTsConfig = await this.readJson("tsconfig.json");
     const filteredKeys = Object.keys(rootTsConfig.compilerOptions.paths ?? {}).filter((key) => key !== name && key !== `${name}/*`);
-    rootTsConfig.compilerOptions.paths = Object.fromEntries(filteredKeys.map((key) => [
-      key,
-      rootTsConfig.compilerOptions.paths?.[key] ?? []
-    ]));
+    rootTsConfig.compilerOptions.paths = Object.fromEntries(filteredKeys.map((key) => [key, rootTsConfig.compilerOptions.paths?.[key] ?? []]));
     if (rootTsConfig.references) {
       rootTsConfig.references = rootTsConfig.references.filter((ref) => ref.path !== `./pkgs/${name}/tsconfig.json`);
     }
@@ -3217,11 +3235,7 @@ class SysExecutor extends Executor {
   name;
   type;
   emoji;
-  constructor({
-    workspace = WorkspaceExecutor.fromRoot(),
-    name,
-    type
-  }) {
+  constructor({ workspace = WorkspaceExecutor.fromRoot(), name, type }) {
     super(name, `${workspace.workspaceRoot}/${type}s/${name}`);
     this.workspace = workspace;
     this.name = name;
@@ -3324,10 +3338,7 @@ class SysExecutor extends Executor {
       },
       devDependencies: {
         ...Object.fromEntries(Object.entries(libPackageJson.devDependencies ?? {}).filter(([dep]) => !dependencySet.has(dep))),
-        ...Object.fromEntries(devDependencies.filter((dep) => rootPackageJson.dependencies?.[dep] || rootPackageJson.devDependencies?.[dep]).sort().map((dep) => [
-          dep,
-          rootPackageJson.devDependencies?.[dep] ?? rootPackageJson.dependencies?.[dep]
-        ]))
+        ...Object.fromEntries(devDependencies.filter((dep) => rootPackageJson.dependencies?.[dep] || rootPackageJson.devDependencies?.[dep]).sort().map((dep) => [dep, rootPackageJson.devDependencies?.[dep] ?? rootPackageJson.dependencies?.[dep]]))
       }
     };
     await this.setPackageJson(libPkgJsonWithDeps);
@@ -3394,11 +3405,7 @@ class SysExecutor extends Executor {
       ...await LibExecutor.from(this, lib).getConstantFiles(),
       ...await LibExecutor.from(this, lib).getScalarConstantFiles()
     ]));
-    return [
-      ...sysContantFiles,
-      ...sysScalarConstantFiles,
-      ...libConstantFiles.flat()
-    ];
+    return [...sysContantFiles, ...sysScalarConstantFiles, ...libConstantFiles.flat()];
   }
   async getDictionaryFiles() {
     const modules = await this.getModules();
@@ -3407,10 +3414,7 @@ class SysExecutor extends Executor {
   async applyTemplate(options) {
     const dict = {
       ...options.dict ?? {},
-      ...Object.fromEntries(Object.entries(options.dict ?? {}).map(([key, value]) => [
-        capitalize(key),
-        capitalize(value)
-      ]))
+      ...Object.fromEntries(Object.entries(options.dict ?? {}).map(([key, value]) => [capitalize(key), capitalize(value)]))
     };
     const scanInfo = await this.scan();
     const fileContents = await this._applyTemplate({
@@ -3443,6 +3447,13 @@ class AppExecutor extends SysExecutor {
   getEnv() {
     return WorkspaceExecutor.getBaseDevEnv().env;
   }
+  async getDevPort() {
+    const basePort = 8282;
+    const appNames = (await this.workspace.getApps()).sort((a, b) => a.localeCompare(b));
+    const appIndex = Math.max(appNames.indexOf(this.name), 0);
+    const portOffset = WorkspaceExecutor.getBaseDevEnv().portOffset;
+    return basePort + appIndex + portOffset;
+  }
   getCommandEnv(env = {}) {
     const basePort = 8282;
     const portOffset = WorkspaceExecutor.getBaseDevEnv().portOffset;
@@ -3469,17 +3480,19 @@ class AppExecutor extends SysExecutor {
     if (type === "build") {
       if (await this.exists(this.dist.cwdPath))
         await this.dist.exec(`rm -rf ${this.dist.cwdPath}`);
-      await Promise.all([
-        this.dist.mkdir("private"),
-        this.dist.mkdir("public")
-      ]);
+      await Promise.all([this.dist.mkdir("private"), this.dist.mkdir("public")]);
       await Promise.all([
         this.cp("private", `${this.dist.cwdPath}/private`),
         this.cp("public", `${this.dist.cwdPath}/public`)
       ]);
     } else
       await this.removeDir(".akan");
-    const env = this.getCommandEnv({ AKAN_COMMAND_TYPE: type, ...routeEnv });
+    const devPort = type === "start" ? (await this.getDevPort()).toString() : undefined;
+    const env = this.getCommandEnv({
+      AKAN_COMMAND_TYPE: type,
+      ...routeEnv,
+      ...devPort ? { PORT: devPort, AKAN_PUBLIC_CLIENT_PORT: devPort, AKAN_PUBLIC_SERVER_PORT: devPort } : {}
+    });
     return { env };
   }
   #publicEnv = null;
@@ -3515,9 +3528,7 @@ class AppExecutor extends SysExecutor {
     return this.#akanConfig;
   }
   #pageKeys = null;
-  async getPageKeys({
-    refresh
-  } = {}) {
+  async getPageKeys({ refresh } = {}) {
     if (this.#pageKeys && !refresh)
       return this.#pageKeys;
     const akanConfig2 = await this.getConfig();
@@ -3566,10 +3577,7 @@ class AppExecutor extends SysExecutor {
     const projectAssetsPath = `${this.cwdPath}/private`;
     const projectPublicLibPath = `${projectPublicPath}/libs`;
     const projectAssetsLibPath = `${projectAssetsPath}/libs`;
-    await Promise.all([
-      this.removeDir(projectPublicLibPath),
-      this.removeDir(projectAssetsLibPath)
-    ]);
+    await Promise.all([this.removeDir(projectPublicLibPath), this.removeDir(projectAssetsLibPath)]);
     const targetPublicDeps = [];
     for (const dep of libDeps) {
       if (await this.exists(`${this.workspace.workspaceRoot}/libs/${dep}/public`))
@@ -3587,10 +3595,7 @@ class AppExecutor extends SysExecutor {
       ...targetAssetsDeps.map((dep) => this.cp(`${this.workspace.workspaceRoot}/libs/${dep}/private`, `${projectAssetsLibPath}/${dep}`))
     ]);
   }
-  async scanSync({
-    refresh = false,
-    write = true
-  } = {}) {
+  async scanSync({ refresh = false, write = true } = {}) {
     const scanInfo = await this.scan({
       refresh,
       write,
@@ -3639,10 +3644,7 @@ class PkgExecutor extends Executor {
   name;
   dist;
   emoji = execEmoji.pkg;
-  constructor({
-    workspace = WorkspaceExecutor.fromRoot(),
-    name
-  }) {
+  constructor({ workspace = WorkspaceExecutor.fromRoot(), name }) {
     super(name, `${workspace.workspaceRoot}/pkgs/${name}`);
     this.workspace = workspace;
     this.name = name;
@@ -3706,10 +3708,7 @@ class PkgExecutor extends Executor {
     };
   }
   async updatePackageJsonDependencies(dependencies = [], devDependencies = []) {
-    const [rootPackageJson, pkgJson] = await Promise.all([
-      this.workspace.getPackageJson(),
-      this.getPackageJson()
-    ]);
+    const [rootPackageJson, pkgJson] = await Promise.all([this.workspace.getPackageJson(), this.getPackageJson()]);
     const dependencyMaps = await this.#toDependencyMap(rootPackageJson, dependencies, devDependencies);
     const newPkgJson = {
       ...pkgJson,
@@ -3719,10 +3718,7 @@ class PkgExecutor extends Executor {
     return newPkgJson;
   }
   async generateDistPackageJson(dependencies = [], devDependencies = []) {
-    const [rootPackageJson, pkgJson] = await Promise.all([
-      this.workspace.getPackageJson(),
-      this.getPackageJson()
-    ]);
+    const [rootPackageJson, pkgJson] = await Promise.all([this.workspace.getPackageJson(), this.getPackageJson()]);
     const dependencyMaps = await this.#toDependencyMap(rootPackageJson, dependencies, devDependencies);
     const distPkgJson = {
       ...pkgJson,
@@ -3738,10 +3734,7 @@ class PkgExecutor extends Executor {
       engines: { bun: ">=1.3.13" },
       ...dependencyMaps
     };
-    await Promise.all([
-      this.dist.writeJson("package.json", distPkgJson),
-      this.writeJson("package.json", distPkgJson)
-    ]);
+    await Promise.all([this.dist.writeJson("package.json", distPkgJson), this.writeJson("package.json", distPkgJson)]);
     return distPkgJson;
   }
   async build() {
@@ -3754,10 +3747,7 @@ class PkgExecutor extends Executor {
     await this.cp(`${this.cwdPath}/dist`, this.dist.cwdPath);
   }
   async generateTsconfigJson() {
-    const [rootTsconfig, pkgTsconfig] = await Promise.all([
-      this.workspace.getTsConfig(),
-      this.getTsConfig()
-    ]);
+    const [rootTsconfig, pkgTsconfig] = await Promise.all([this.workspace.getTsConfig(), this.getTsConfig()]);
     const tsconfig = {
       ...rootTsconfig,
       ...pkgTsconfig,
@@ -4628,6 +4618,9 @@ export async function generateHead(props: PageProps) {
   return inheritedLayout.head;
 }
 
+export const NotFound = userLayout.NotFound ?? inheritedLayout.NotFound;
+export const Error = userLayout.Error ?? inheritedLayout.Error;
+
 export default function GeneratedLayout({ children, params, searchParams }: LayoutProps) {
   return (
     <System.Provider
@@ -4657,6 +4650,9 @@ export async function generateHead(props: PageProps) {
   return inheritedLayout.head;
 }
 
+export const NotFound = userLayout.NotFound ?? inheritedLayout.NotFound;
+export const Error = userLayout.Error ?? inheritedLayout.Error;
+
 export default function GeneratedLayout({ children, params, searchParams }: LayoutProps) {
   return <UserLayout params={params} searchParams={searchParams}>{children}</UserLayout>;
 }
@@ -10051,6 +10047,7 @@ import { jsxDEV as jsxDEV2, Fragment as Fragment2 } from "react/jsx-dev-runtime"
 import { select as select6 } from "@inquirer/prompts";
 
 // pkgs/@akanjs/cli/application/application.script.ts
+import { confirm as confirm3 } from "@inquirer/prompts";
 import { Logger as Logger12 } from "akanjs/common";
 
 // pkgs/@akanjs/cli/semver.ts
@@ -10254,7 +10251,7 @@ class ApplicationRunner extends runner("application") {
     const appHost = await new AkanAppHost(app, { env, withInk }).start();
     onStart?.();
     if (open)
-      setTimeout(() => openBrowser("http://localhost:8282"), 3000);
+      setTimeout(() => openBrowser(`http://localhost:${env.AKAN_PUBLIC_CLIENT_PORT ?? env.PORT ?? "8282"}`), 3000);
     return appHost;
   }
   async buildIos(app, { target, env = "debug", regenerate = false } = {}) {
@@ -10479,7 +10476,38 @@ ${detail}`
 }
 
 // pkgs/@akanjs/cli/application/application.script.ts
-class ApplicationScript extends script("application", [ApplicationRunner, LibraryScript]) {
+class ApplicationScript extends script("application", [
+  ApplicationRunner,
+  LibraryScript
+]) {
+  async confirmDatabaseModeDependencyInstall(databaseMode, installSpecs) {
+    return await confirm3({
+      message: [
+        `Database mode '${databaseMode}' requires missing dependencies: ${installSpecs.join(", ")}.`,
+        "Install them now?"
+      ].join(" "),
+      default: true
+    });
+  }
+  async syncDatabaseModeDependencies(app, akanConfig3, databaseMode) {
+    const installSpecs = akanConfig3.getMissingDatabaseModeDependencySpecs(databaseMode);
+    if (installSpecs.length === 0)
+      return;
+    const shouldInstall = await this.confirmDatabaseModeDependencyInstall(databaseMode, installSpecs);
+    if (!shouldInstall)
+      throw new Error(`Database mode '${databaseMode}' requires missing dependencies: ${installSpecs.join(", ")}.`);
+    const spinner2 = app.workspace.spinning(`Installing database dependencies for ${databaseMode} mode...`);
+    try {
+      await app.workspace.spawn("bun", ["add", ...installSpecs], {
+        stdio: "inherit"
+      });
+      await app.workspace.getPackageJson({ refresh: true });
+      spinner2.succeed(`Installed database dependencies for ${databaseMode} mode`);
+    } catch (error) {
+      spinner2.fail(`Failed to install database dependencies for ${databaseMode} mode`);
+      throw error;
+    }
+  }
   async createApplication(appName, workspace, { start = false, libs = [] } = {}) {
     const spinner2 = workspace.spinning("Creating application...");
     const app = await this.applicationRunner.createApplication(appName, workspace, libs);
@@ -10504,7 +10532,11 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     await app.scanSync();
     await this.applicationRunner.runScript(app, scriptFilename);
   }
-  async build(app, { write = true, fast = false, quiet = false } = {}) {
+  async build(app, {
+    write = true,
+    fast = false,
+    quiet = false
+  } = {}) {
     await app.scanSync({ write });
     if (!quiet)
       Logger12.rawLog(`Creating an optimized production build for ${app.name}...`);
@@ -10522,7 +10554,11 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
       throw error;
     }
   }
-  async typecheck(app, { write = true, clean = false, incremental = true } = {}) {
+  async typecheck(app, {
+    write = true,
+    clean = false,
+    incremental = true
+  } = {}) {
     await app.scanSync({ write });
     const spinner2 = app.spinning(`Typechecking ${app.name}...`);
     try {
@@ -10564,6 +10600,7 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     await app.scanSync({ write });
     const akanConfig3 = await app.getConfig();
     const databaseMode = process.env.AKAN_DATABASE_MODE ?? akanConfig3.defaultDatabaseMode ?? "single";
+    await this.syncDatabaseModeDependencies(app, akanConfig3, databaseMode);
     if (app.getEnv() === "local" && dbup && databaseMode !== "single") {
       const wasDbAlreadyUp = await this.dbup(app.workspace, databaseMode);
       if (!wasDbAlreadyUp)
@@ -10582,7 +10619,12 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     });
     return akanAppHost;
   }
-  async buildIos(app, { write = true, target, env = "debug", regenerate = false } = {}) {
+  async buildIos(app, {
+    write = true,
+    target,
+    env = "debug",
+    regenerate = false
+  } = {}) {
     await app.scanSync({ write });
     await this.applicationRunner.buildIos(app, { target, env, regenerate });
   }
@@ -10595,15 +10637,32 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     regenerate = false
   } = {}) {
     await app.scanSync({ write });
-    await this.applicationRunner.startIos(app, { open, operation, env, target, regenerate });
+    await this.applicationRunner.startIos(app, {
+      open,
+      operation,
+      env,
+      target,
+      regenerate
+    });
   }
-  async releaseIos(app, { write = true, target, env = "main", regenerate = false, allowLocalRelease = false } = {}) {
+  async releaseIos(app, {
+    write = true,
+    target,
+    env = "main",
+    regenerate = false,
+    allowLocalRelease = false
+  } = {}) {
     await app.scanSync({ write });
     if (env === "local" && !allowLocalRelease)
       throw new Error("releaseIos --env local is blocked. Pass allowLocalRelease only for explicit local release testing.");
     await this.applicationRunner.releaseIos(app, { target, env, regenerate });
   }
-  async buildAndroid(app, { write = true, target, env = "debug", regenerate = false } = {}) {
+  async buildAndroid(app, {
+    write = true,
+    target,
+    env = "debug",
+    regenerate = false
+  } = {}) {
     await app.scanSync({ write });
     await this.applicationRunner.buildAndroid(app, { target, env, regenerate });
   }
@@ -10616,13 +10675,29 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     regenerate = false
   } = {}) {
     await app.scanSync({ write });
-    await this.applicationRunner.startAndroid(app, { open, operation, env, target, regenerate });
+    await this.applicationRunner.startAndroid(app, {
+      open,
+      operation,
+      env,
+      target,
+      regenerate
+    });
   }
-  async releaseAndroid(app, assembleType, { write = true, target, env = "main", regenerate = false, allowLocalRelease = false } = {}) {
+  async releaseAndroid(app, assembleType, {
+    write = true,
+    target,
+    env = "main",
+    regenerate = false,
+    allowLocalRelease = false
+  } = {}) {
     await app.scanSync({ write });
     if (env === "local" && !allowLocalRelease)
       throw new Error("releaseAndroid --env local is blocked. Pass allowLocalRelease only for explicit local release testing.");
-    await this.applicationRunner.releaseAndroid(app, assembleType, { target, env, regenerate });
+    await this.applicationRunner.releaseAndroid(app, assembleType, {
+      target,
+      env,
+      regenerate
+    });
   }
   async configureApp(app) {
     await this.applicationRunner.configureApp(app);
@@ -10933,7 +11008,7 @@ class PackageScript extends script("package", [PackageRunner]) {
 
 // pkgs/@akanjs/cli/cloud/cloud.runner.ts
 import path38 from "path";
-import { confirm as confirm3, input as input5, select as select7 } from "@inquirer/prompts";
+import { confirm as confirm4, input as input5, select as select7 } from "@inquirer/prompts";
 import { Logger as Logger14, sleep } from "akanjs/common";
 import chalk7 from "chalk";
 import * as QRcode from "qrcode";
@@ -10959,12 +11034,7 @@ var addRemoteEnvServerValue = "__addRemoteEnvServer";
 var removeRemoteEnvServerValue = "__removeRemoteEnvServer";
 
 class CloudRunner extends runner("cloud") {
-  #akanFrameworkPackages = new Set([
-    "akanjs",
-    "@akanjs/devkit",
-    "@akanjs/cli",
-    "create-akan-workspace"
-  ]);
+  #akanFrameworkPackages = new Set(["akanjs", "@akanjs/devkit", "@akanjs/cli", "create-akan-workspace"]);
   #getRegistryArgs(registryUrl) {
     return registryUrl ? ["--registry", getNpmRegistryUrl(registryUrl)] : [];
   }
@@ -11047,7 +11117,7 @@ class CloudRunner extends runner("cloud") {
         value: name
       }))
     });
-    const shouldRemove = await confirm3({
+    const shouldRemove = await confirm4({
       message: `Remove remote env server "${selectedName}"?`,
       default: false
     });
@@ -11085,22 +11155,14 @@ class CloudRunner extends runner("cloud") {
     return `${config.username ? `${config.username}@` : ""}${config.host}`;
   }
   #getScpArgs(config, source, target) {
-    return [
-      ...config.port ? ["-P", config.port.toString()] : [],
-      source,
-      target
-    ];
+    return [...config.port ? ["-P", config.port.toString()] : [], source, target];
   }
   #getSshArgs(config, command3) {
-    return [
-      ...config.port ? ["-p", config.port.toString()] : [],
-      this.#getSshTarget(config),
-      command3
-    ];
+    return [...config.port ? ["-p", config.port.toString()] : [], this.#getSshTarget(config), command3];
   }
-  async login() {
+  async login(workspace) {
     const config = await GlobalConfig.getHostConfig();
-    const cloudApi2 = new CloudApi(config);
+    const cloudApi2 = new CloudApi(workspace, config);
     const self = config.auth ? await cloudApi2.getRemoteSelf() : null;
     if (self) {
       Logger14.rawLog(chalk7.green(`
@@ -11207,7 +11269,7 @@ ${chalk7.green("\u27A4")} Authentication Required`));
       await workspace.writeJson(`dist/pkgs/${library}/package.json`, newDistPackageJson);
     }
     if (confirmPublish) {
-      const isDeployConfirmed = await confirm3({
+      const isDeployConfirmed = await confirm4({
         message: "Are you sure you want to deploy the libraries?"
       });
       if (!isDeployConfirmed) {
@@ -11217,13 +11279,7 @@ ${chalk7.green("\u27A4")} Authentication Required`));
     }
     await Promise.all(akanPkgs.map(async (library) => {
       Logger14.info(`Publishing ${library}@${nextVersion} to ${registry ?? "npm"}...`);
-      await workspace.spawn("npm", [
-        "publish",
-        "--tag",
-        tag,
-        ...this.#getRegistryArgs(registry),
-        ...this.#getLocalRegistryAuthArgs(registry)
-      ], {
+      await workspace.spawn("npm", ["publish", "--tag", tag, ...this.#getRegistryArgs(registry), ...this.#getLocalRegistryAuthArgs(registry)], {
         cwd: path38.join(workspace.workspaceRoot, "dist/pkgs", library),
         env: this.#getRegistryEnv(registry),
         stdio: "inherit"
@@ -11240,14 +11296,7 @@ ${chalk7.green("\u27A4")} Authentication Required`));
       await workspace.spawn("bun", ["update", "-g", "akanjs", "--latest", `--tag=${tag}`, ...registryArgs], { env });
     else
       await Promise.all([
-        workspace.spawn("bun", [
-          "update",
-          "-g",
-          "akanjs",
-          "--latest",
-          `--tag=${tag}`,
-          ...registryArgs
-        ], { env }),
+        workspace.spawn("bun", ["update", "-g", "akanjs", "--latest", `--tag=${tag}`, ...registryArgs], { env }),
         this.#updateAkanPkgs(workspace, tag, registry)
       ]);
   }
@@ -11271,12 +11320,7 @@ ${chalk7.green("\u27A4")} Authentication Required`));
   }
   #normalizeAkanPackageJson(packageJson, packageName, version) {
     const normalized = { ...packageJson, version };
-    for (const field of [
-      "dependencies",
-      "devDependencies",
-      "peerDependencies",
-      "optionalDependencies"
-    ]) {
+    for (const field of ["dependencies", "devDependencies", "peerDependencies", "optionalDependencies"]) {
       const dependencies = normalized[field];
       if (!dependencies)
         continue;
@@ -11291,7 +11335,7 @@ ${chalk7.green("\u27A4")} Authentication Required`));
     const envArchivePath = "local/env.tar";
     await workspace.mkdir("local");
     await workspace.remove(envArchivePath);
-    await cloudApi2.downloadEnv(workspaceId, path38.join(workspace.workspaceRoot, envArchivePath));
+    await cloudApi2.downloadEnv(workspaceId);
     await workspace.spawn("tar", ["-xf", envArchivePath], {
       cwd: workspace.workspaceRoot
     });
@@ -11362,13 +11406,9 @@ ${chalk7.green("\u27A4")} Authentication Required`));
 }
 
 // pkgs/@akanjs/cli/cloud/cloud.script.ts
-class CloudScript extends script("cloud", [
-  CloudRunner,
-  ApplicationScript,
-  PackageScript
-]) {
+class CloudScript extends script("cloud", [CloudRunner, ApplicationScript, PackageScript]) {
   async login(workspace) {
-    await this.cloudRunner.login();
+    await this.cloudRunner.login(workspace);
   }
   async logout(workspace) {
     await this.cloudRunner.logout();
@@ -11386,7 +11426,7 @@ class CloudScript extends script("cloud", [
   async downloadEnv(workspace) {
     const workspaceId = workspace.getWorkspaceId({ allowEmpty: true });
     if (workspaceId) {
-      const cloudApi2 = await CloudApi.fromHost();
+      const cloudApi2 = await CloudApi.fromHost(workspace);
       await this.cloudRunner.downloadEnv(cloudApi2, workspace, workspaceId);
       return;
     }
@@ -11396,7 +11436,7 @@ class CloudScript extends script("cloud", [
     const workspaceId = workspace.getWorkspaceId({ allowEmpty: true });
     const { path: path39 } = await this.cloudRunner.gatherEnvFiles(workspace);
     if (workspaceId) {
-      const cloudApi2 = await CloudApi.fromHost();
+      const cloudApi2 = await CloudApi.fromHost(workspace);
       await this.cloudRunner.uploadEnv(cloudApi2, workspaceId, path39);
       return;
     }
@@ -11471,7 +11511,8 @@ class CloudCommand extends command("cloud", [CloudScript], ({ public: target })
     enum: [
       { label: "npm", value: "npm" },
       { label: "local", value: "local" }
-    ]
+    ],
+    default: process.env.USE_AKANJS_PKGS === "true" ? undefined : "npm"
   }).exec(async function(workspace, tag, registry) {
     await this.cloudScript.update(workspace, tag, {
       registryUrl: resolveRegistryUrl(registry)