@igoruehara/canvas-flow 0.1.0 → 0.1.2

package/README.md

@@ -12,22 +12,22 @@ Canvas Flow roda frontend e backend juntos a partir de um pacote npm.
 Este caminho sobe MongoDB local automaticamente e abre o navegador.
 
 ```bash
-npx canvas-flow@latest --with-docker --open
+npx @igoruehara/canvas-flow@latest --with-docker --open
 ```
 
 Para RAG local com Milvus, MinIO e etcd:
 
 ```bash
-npx canvas-flow@latest infra up --full
-npx canvas-flow@latest --open
+npx @igoruehara/canvas-flow@latest infra up --full
+npx @igoruehara/canvas-flow@latest --open
 ```
 
 Comandos uteis:
 
 ```bash
-npx canvas-flow@latest infra status
-npx canvas-flow@latest infra logs
-npx canvas-flow@latest infra down
+npx @igoruehara/canvas-flow@latest infra status
+npx @igoruehara/canvas-flow@latest infra logs
+npx @igoruehara/canvas-flow@latest infra down
 ```
 
 `infra down` para os containers, mas mantem os volumes Docker.
@@ -37,7 +37,7 @@ npx canvas-flow@latest infra down
 Use este caminho quando voce ja tem MongoDB local, Atlas ou outro Mongo remoto.
 
 ```bash
-npx canvas-flow@latest --open
+npx @igoruehara/canvas-flow@latest --open
 ```
 
 Mongo local padrao:
@@ -49,7 +49,7 @@ mongodb://127.0.0.1:27017/canvas_flow
 Para usar outro Mongo, edite a config:
 
 ```bash
-npx canvas-flow@latest config --edit
+npx @igoruehara/canvas-flow@latest config --edit
 ```
 
 ```json
@@ -77,13 +77,13 @@ C:\Users\<usuario>\.canvas-flow\config.json
 Abrir a config:
 
 ```bash
-npx canvas-flow@latest config --edit
+npx @igoruehara/canvas-flow@latest config --edit
 ```
 
 Ver o caminho da config:
 
 ```bash
-npx canvas-flow@latest config
+npx @igoruehara/canvas-flow@latest config
 ```
 
 Exemplo com OpenAI:
@@ -112,7 +112,7 @@ Exemplo com porta customizada:
 Tambem da para usar outro arquivo:
 
 ```bash
-npx canvas-flow@latest --config C:\canvas-flow\config.json --open
+npx @igoruehara/canvas-flow@latest --config C:\canvas-flow\config.json --open
 ```
 
 Nao publique `config.json`: ele contem tokens e secrets gerados.
@@ -120,13 +120,13 @@ Nao publique `config.json`: ele contem tokens e secrets gerados.
 ## Validar
 
 ```bash
-npx canvas-flow@latest doctor
+npx @igoruehara/canvas-flow@latest doctor
 ```
 
 Sem checar rede/Mongo:
 
 ```bash
-npx canvas-flow@latest doctor --offline
+npx @igoruehara/canvas-flow@latest doctor --offline
 ```
 
 ## Instalar globalmente
@@ -134,7 +134,7 @@ npx canvas-flow@latest doctor --offline
 Opcional:
 
 ```bash
-npm i -g canvas-flow
+npm i -g @igoruehara/canvas-flow
 canvas-flow --with-docker --open
 ```
 

package/bin/canvas-flow.js

@@ -50,6 +50,7 @@ Options:
   --edit                      Open config file with "init" or "config"
   --force                     Overwrite config on init
   --offline                   Skip network checks with "doctor"
+  --skip-mongo-check          Start without preflight MongoDB connection check
   --strict                    Treat doctor warnings as failures
   --help                      Show this help
 
@@ -810,6 +811,48 @@ async function checkMongoReachability(uri) {
   };
 }
 
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+function mongoConnectionOptions(config) {
+  return {
+    serverSelectionTimeoutMS: Number(config.database?.mongoServerSelectionTimeoutMs || 8000),
+    connectTimeoutMS: Number(config.database?.mongoConnectTimeoutMs || 8000),
+  };
+}
+
+async function checkMongoConnection(uri, options = {}) {
+  let connection;
+  try {
+    const mongoose = require('mongoose');
+    connection = mongoose.createConnection(uri, options);
+    await connection.asPromise();
+    return { ok: true, message: 'connected' };
+  } catch (error) {
+    return { ok: false, message: error && error.message ? error.message : String(error) };
+  } finally {
+    if (connection) {
+      await connection.close().catch(() => undefined);
+    }
+  }
+}
+
+function isLocalMongoUri(uri) {
+  return mongoTargetsFromUri(uri).some((target) => (
+    target.host === '127.0.0.1' ||
+    target.host === 'localhost' ||
+    target.host === '::1'
+  ));
+}
+
+function mongoConnectionHint(uri) {
+  if (isLocalMongoUri(uri)) {
+    return 'Start local Mongo with "canvas-flow infra up", or run with "canvas-flow --with-docker --open".';
+  }
+  return 'Check database.mongoUrl credentials, network access, and the MongoDB Atlas IP access list.';
+}
+
 function dockerComposeBaseArgs() {
   return [
     'compose',
@@ -936,6 +979,7 @@ function createDoctorReporter(strict) {
 
 async function doctor(flags) {
   const reporter = createDoctorReporter(flags.strict === true);
+  addSourceDependencyFallback();
   const paths = resolvePaths(flags);
   ensureDir(paths.homeDir);
 
@@ -975,11 +1019,11 @@ async function doctor(flags) {
   if (config.database.mongoUrl) {
     reporter.pass('Mongo config', 'MONGO_DB_CONNECTION_STRING is set');
     if (flags.offline === true) {
-      reporter.warn('Mongo reachability', 'skipped because --offline was used');
+      reporter.warn('Mongo connection', 'skipped because --offline was used');
     } else {
-      const mongoCheck = await checkMongoReachability(config.database.mongoUrl);
-      if (mongoCheck.ok) reporter.pass('Mongo reachability', mongoCheck.message);
-      else reporter.fail('Mongo reachability', `${mongoCheck.message}; run "canvas-flow infra up" to start local Mongo with Docker`);
+      const mongoCheck = await checkMongoConnection(config.database.mongoUrl, mongoConnectionOptions(config));
+      if (mongoCheck.ok) reporter.pass('Mongo connection', mongoCheck.message);
+      else reporter.fail('Mongo connection', `${mongoCheck.message}; ${mongoConnectionHint(config.database.mongoUrl)}`);
     }
   } else {
     reporter.fail('Mongo config', 'database.mongoUrl is required');
@@ -1044,7 +1088,41 @@ async function doctor(flags) {
   reporter.finish();
 }
 
-function start(flags) {
+async function waitForMongo(config, flags, paths) {
+  if (flags['skip-mongo-check'] === true) return;
+  if (!config.database.mongoUrl) {
+    throw new Error(`database.mongoUrl is required. Edit the config with: canvas-flow config --edit`);
+  }
+
+  const attempts = (flags['with-docker'] === true || flags.infra === true) && isLocalMongoUri(config.database.mongoUrl)
+    ? 20
+    : 1;
+  const options = mongoConnectionOptions(config);
+  let lastMessage = '';
+
+  for (let attempt = 1; attempt <= attempts; attempt += 1) {
+    const result = await checkMongoConnection(config.database.mongoUrl, options);
+    if (result.ok) {
+      console.log('MongoDB preflight: connected');
+      return;
+    }
+
+    lastMessage = result.message;
+    if (attempt < attempts) {
+      console.log(`MongoDB preflight waiting (${attempt}/${attempts}): ${result.message}`);
+      await sleep(1500);
+    }
+  }
+
+  throw new Error([
+    `MongoDB preflight failed: ${lastMessage}`,
+    mongoConnectionHint(config.database.mongoUrl),
+    `Config file: ${paths.configPath}`,
+    'Use "canvas-flow doctor" for a detailed readiness check.',
+  ].join('\n'));
+}
+
+async function start(flags) {
   assertBundleExists();
   addSourceDependencyFallback();
   if (flags['with-docker'] === true || flags.infra === true) {
@@ -1055,6 +1133,7 @@ function start(flags) {
   const configExisted = fs.existsSync(paths.configPath);
   const config = loadConfig(paths.configPath);
   const runtime = applyEnvironment(config, paths, flags);
+  await waitForMongo(config, flags, paths);
 
   process.chdir(paths.homeDir);
 
@@ -1117,7 +1196,7 @@ async function main() {
   }
 
   if (args.command === 'start' || args.command === 'run') {
-    start(args.flags);
+    await start(args.flags);
     return;
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
- "name": "@igoruehara/canvas-flow",
-  "version": "0.1.0",
+  "name": "@igoruehara/canvas-flow",
+  "version": "0.1.2",
   "description": "Standalone npm launcher for Canvas Flow multi-agent GenAI workflows.",
   "license": "MIT",
   "type": "commonjs",
@@ -65,4 +65,4 @@
   "overrides": {
     "uuid": "^11.1.1"
   }
-}
+}

package/server/database/database.providers.js

@@ -12,13 +12,17 @@ exports.databaseProviders = [
             const uri = configService.get('MONGO_DB_CONNECTION_STRING') ||
                 'mongodb://127.0.0.1:27017/canvas_flow';
             mongoose.set('bufferCommands', false);
-            await mongoose
-                .connect(uri, {
-                serverSelectionTimeoutMS: Number(configService.get('MONGO_SERVER_SELECTION_TIMEOUT_MS') || 8000),
-                connectTimeoutMS: Number(configService.get('MONGO_CONNECT_TIMEOUT_MS') || 8000),
-            })
-                .then(() => console.log('MongoDB connected'))
-                .catch((error) => console.warn(`MongoDB connection skipped: ${error?.message || String(error)}`));
+            try {
+                await mongoose.connect(uri, {
+                    serverSelectionTimeoutMS: Number(configService.get('MONGO_SERVER_SELECTION_TIMEOUT_MS') || 8000),
+                    connectTimeoutMS: Number(configService.get('MONGO_CONNECT_TIMEOUT_MS') || 8000),
+                });
+                console.log('MongoDB connected');
+            }
+            catch (error) {
+                console.error(`MongoDB connection failed: ${error?.message || String(error)}`);
+                throw error;
+            }
             return mongoose;
         },
     },

package/server/database/database.providers.js.map

@@ -1 +1 @@
-{"version":3,"file":"database.providers.js","sourceRoot":"","sources":["../../src/database/database.providers.ts"],"names":[],"mappings":";;;AAAA,qCAAqC;AACrC,2CAA+C;AAC/C,4DAAuE;AAE1D,QAAA,iBAAiB,GAAG;IAC/B;QACE,OAAO,EAAE,iDAA8B;QACvC,MAAM,EAAE,CAAC,sBAAa,CAAC;QACvB,UAAU,EAAE,KAAK,EAAE,aAA4B,EAA4B,EAAE;YAC3E,MAAM,GAAG,GACP,aAAa,CAAC,GAAG,CAAS,4BAA4B,CAAC;gBACvD,uCAAuC,CAAC;YAC1C,QAAQ,CAAC,GAAG,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;YACtC,MAAM,QAAQ;iBACX,OAAO,CAAC,GAAG,EAAE;gBACZ,wBAAwB,EAAE,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,mCAAmC,CAAC,IAAI,IAAI,CAAC;gBAChG,gBAAgB,EAAE,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,0BAA0B,CAAC,IAAI,IAAI,CAAC;aAChF,CAAC;iBACD,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;iBAC5C,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,+BAA+B,KAAK,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;YACpG,OAAO,QAAQ,CAAC;QAClB,CAAC;KACF;CACF,CAAC"}
+{"version":3,"file":"database.providers.js","sourceRoot":"","sources":["../../src/database/database.providers.ts"],"names":[],"mappings":";;;AAAA,qCAAqC;AACrC,2CAA+C;AAC/C,4DAAuE;AAE1D,QAAA,iBAAiB,GAAG;IAC/B;QACE,OAAO,EAAE,iDAA8B;QACvC,MAAM,EAAE,CAAC,sBAAa,CAAC;QACvB,UAAU,EAAE,KAAK,EAAE,aAA4B,EAA4B,EAAE;YAC3E,MAAM,GAAG,GACP,aAAa,CAAC,GAAG,CAAS,4BAA4B,CAAC;gBACvD,uCAAuC,CAAC;YAC1C,QAAQ,CAAC,GAAG,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;YACtC,IAAI,CAAC;gBACH,MAAM,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE;oBAC1B,wBAAwB,EAAE,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,mCAAmC,CAAC,IAAI,IAAI,CAAC;oBAChG,gBAAgB,EAAE,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,0BAA0B,CAAC,IAAI,IAAI,CAAC;iBAChF,CAAC,CAAC;gBACH,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;YACnC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,KAAK,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAC/E,MAAM,KAAK,CAAC;YACd,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC;KACF;CACF,CAAC"}