@lacrous/omnicloud 0.2.6 → 0.2.7

package/dist/cli.js

@@ -2,9 +2,11 @@
 
 // src/cli.ts
 import { spawn } from "child_process";
-import { existsSync, readFileSync, realpathSync } from "fs";
+import { randomBytes } from "crypto";
+import { chmodSync, existsSync, readFileSync, realpathSync, writeFileSync } from "fs";
 import { createRequire } from "module";
 import { dirname, join, resolve } from "path";
+import { createInterface } from "readline/promises";
 import { fileURLToPath } from "url";
 var packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
 var serverDir = join(packageRoot, "server");
@@ -182,7 +184,19 @@ ${USAGE}`);
 `);
     return 0;
   }
-  loadEnvFile(resolve(args.envFile ?? ".env"), env);
+  const envPath = resolve(args.envFile ?? ".env");
+  if (args.command === "start" && !existsSync(envPath) && !env.DATABASE_URL) {
+    const outcome = await firstRunSetup(envPath);
+    if (outcome === "not-interactive") {
+      process.stderr.write(
+        `omnicloud: no configuration found. Create ${envPath} (see https://github.com/Lacrous/OmniCloud#configuration) or run omnicloud in a terminal.
+`
+      );
+      return 1;
+    }
+    if (outcome !== "saved") return 1;
+  }
+  loadEnvFile(envPath, env);
   try {
     if (args.command === "migrate") {
       await migrate(env);
@@ -203,6 +217,71 @@ ${USAGE}`);
 ${USAGE}`);
   return 2;
 }
+function buildEnvFile(values) {
+  return [
+    "# Written by `omnicloud` on first run. Keep this file private.",
+    `DATABASE_URL=${values.databaseUrl}`,
+    `TELEGRAM_API_ID=${values.apiId}`,
+    `TELEGRAM_API_HASH=${values.apiHash}`,
+    `OMNICLOUD_ENCRYPTION_KEY=${values.encryptionKey}`,
+    ""
+  ].join("\n");
+}
+function validateSetup(values) {
+  if (!/^postgres(ql)?:\/\/.+@.+\/.+$/.test(values.databaseUrl)) {
+    return "DATABASE_URL must look like postgresql://user:password@host:5432/database";
+  }
+  if (!/^[1-9][0-9]*$/.test(values.apiId)) {
+    return "TELEGRAM_API_ID must be the number shown at my.telegram.org";
+  }
+  if (!/^[0-9a-f]{32}$/i.test(values.apiHash)) {
+    return "TELEGRAM_API_HASH must be the 32-character value shown at my.telegram.org";
+  }
+  return null;
+}
+async function firstRunSetup(envPath) {
+  if (!process.stdin.isTTY) return "not-interactive";
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    process.stdout.write(
+      "\nWelcome to OmniCloud. No .env file was found, so let's create one.\n\n1. PostgreSQL database\n   Format: postgresql://USER:PASSWORD@HOST:PORT/DATABASE\n   The default docker setup uses postgresql://omnicloud:omnicloud@127.0.0.1:5432/omnicloud\n\n2. Telegram API credentials\n   Open https://my.telegram.org, log in, choose 'API development tools',\n   and create an application. Copy the api_id and api_hash.\n\n"
+    );
+    const databaseUrl = (await rl.question("DATABASE_URL: ")).trim();
+    const apiId = (await rl.question("TELEGRAM_API_ID: ")).trim();
+    const apiHash = (await rl.question("TELEGRAM_API_HASH: ")).trim();
+    const problem = validateSetup({ databaseUrl, apiId, apiHash });
+    if (problem) {
+      process.stderr.write(`
+omnicloud: ${problem}
+Run omnicloud again to retry.
+`);
+      return "invalid";
+    }
+    const answer = (await rl.question(`
+Save these settings to ${envPath}? [Y/n] `)).trim().toLowerCase();
+    if (answer === "n" || answer === "no") {
+      process.stdout.write("Nothing was saved.\n");
+      return "declined";
+    }
+    writeFileSync(
+      envPath,
+      buildEnvFile({
+        databaseUrl,
+        apiId,
+        apiHash,
+        encryptionKey: randomBytes(32).toString("hex")
+      }),
+      { mode: 384 }
+    );
+    chmodSync(envPath, 384);
+    process.stdout.write(`Saved ${envPath}. A private encryption key was generated for you.
+
+`);
+    return "saved";
+  } finally {
+    rl.close();
+  }
+}
 function isEntryPoint() {
   const entry = process.argv[1];
   if (!entry) return false;
@@ -216,8 +295,10 @@ if (isEntryPoint()) {
   main(process.argv.slice(2)).then((code) => process.exit(code));
 }
 export {
+  buildEnvFile,
   loadEnvFile,
   main,
   parseArgs,
-  parseEnvFile
+  parseEnvFile,
+  validateSetup
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lacrous/omnicloud",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "SDK and core building blocks for OmniCloud — self-hosted cloud storage powered by your Telegram account.",
   "license": "MIT",
   "type": "module",
@@ -48,9 +48,9 @@
     "prisma": "^6.2.0"
   },
   "devDependencies": {
-    "@omnicloud/core": "0.2.6",
-    "@omnicloud/shared": "0.2.6",
-    "@omnicloud/telegram": "0.2.6",
+    "@omnicloud/core": "0.2.7",
+    "@omnicloud/shared": "0.2.7",
+    "@omnicloud/telegram": "0.2.7",
     "@types/node": "^22.10.0",
     "esbuild": "0.25.12",
     "tsup": "^8.3.0",

package/server/index.js

@@ -4685,7 +4685,7 @@ function encryptionCheck(configured) {
 }
 
 // ../../apps/api/src/routes/storage.ts
-var VERSION = "0.2.6";
+var VERSION = "0.2.7";
 function registerStorageRoutes(app2, container2) {
   app2.get("/api/health", async () => {
     const database = await probeDatabase(container2);