feega 0.1.27 → 0.1.29

package/README.md

@@ -6,7 +6,9 @@ npx feega my-board.feega
 
 Starts feega's local mode on http://localhost:5173 and saves the canvas to `my-board.feega` in the current directory. Needs Node 22+. Each start checks for a newer app and downloads it into `~/.feega/app/<version>/`; offline it uses the newest cached one.
 
-Options: `--port <n>`, `--no-open`. `FEEGA_APP_BUNDLE=<path or url>` uses another bundle.
+Run it inside a project with a `dev` script and it asks once to import the folder: its home page lands on the canvas as an editable frame. `--import` imports without asking, `--no-import` never asks.
+
+Options: `--port <n>`, `--no-open`, `--import`, `--no-import`. `FEEGA_APP_BUNDLE=<path or url>` uses another bundle.
 
 AI keys: put them in the environment or in a `.env` in the folder you run `npx feega` from. Kie.ai, OpenRouter, the text LLM, Higgsfield, Wiro and ElevenLabs are supported; see the local mode docs for the variables.
 

package/bin/feega.mjs

@@ -2,12 +2,13 @@
 import { spawn, spawnSync } from 'node:child_process';
 import { createWriteStream, existsSync, mkdirSync, readFileSync, realpathSync, rmSync } from 'node:fs';
 import { homedir, tmpdir } from 'node:os';
-import { join } from 'node:path';
+import { basename, join } from 'node:path';
+import { createInterface } from 'node:readline/promises';
 import { Readable } from 'node:stream';
 import { pipeline } from 'node:stream/promises';
 
 import { sendTelemetry, telemetryEnv } from '../telemetry.mjs';
-import { MCP_ENTRY, USAGE, appDir, bundleSource, boundUrl, cachedVersions, freePort, isCached, latestAppVersion, markCached, mcpEnv, parseArgs, pickVersion } from '../launcher.mjs';
+import { ImportStep, MCP_ENTRY, USAGE, appDir, bundleSource, boundUrl, cachedVersions, folderApp, freePort, importAsk, importStep, isCached, latestAppVersion, markCached, mcpEnv, parseArgs, pickVersion, placeOf, readyProbe, served } from '../launcher.mjs';
 
 const MIN_NODE_MAJOR = 22;
 const WEBSTORAGE_NODE_MAJOR = 25;
@@ -76,11 +77,13 @@ async function install(dir, version) {
   markCached(dir);
 }
 
-async function openWhenReady(url) {
-  while (!(await fetch(url).then((r) => r.ok, () => false))) {
+async function whenReady(url) {
+  while (!(await fetch(url, readyProbe).then((r) => served(r.status), () => false))) {
     await new Promise((r) => setTimeout(r, READY_POLL_MS));
   }
+}
 
+function openBrowser(url) {
   const [cmd, ...args] = OPENERS[process.platform] ?? ['xdg-open'];
   spawn(cmd, [...args, url], { stdio: 'ignore', detached: true }).on('error', () => {}).unref();
 }
@@ -95,6 +98,37 @@ async function readyApp() {
   return dir;
 }
 
+async function wantsImport(app, file, mode) {
+  const step = importStep({ mode, app, fileExists: existsSync(file), tty: Boolean(process.stdin.isTTY && process.stdout.isTTY) });
+  if (step !== ImportStep.Ask) {
+    return step === ImportStep.Import;
+  }
+
+  const prompt = createInterface({ input: process.stdin, output: process.stdout });
+  const answer = (await prompt.question(`feega: import the current folder (${basename(app)}) into the canvas? (Y/n) `)).trim().toLowerCase();
+  prompt.close();
+  return answer === '' || answer.startsWith('y');
+}
+
+async function importFolder(url, folder) {
+  const home = await fetch(url, readyProbe);
+  const place = placeOf(home.headers.get('location'));
+  if (!place) {
+    throw new Error('could not find the local canvas');
+  }
+
+  console.log(`feega: importing ${basename(folder)} (starts its dev server, can take a minute)…`);
+  const { path, body } = importAsk(place, folder);
+  const res = await fetch(new URL(path, url), { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(body) });
+  if (!res.ok) {
+    const { error, detail } = await res.json().catch(() => ({}));
+    throw new Error(`folder import failed: ${detail ?? error ?? res.status}`);
+  }
+
+  const { pages = [] } = await res.json();
+  console.log(`feega: imported ${basename(folder)} (${pages.length} pages)`);
+}
+
 function forward(child) {
   for (const signal of ['SIGINT', 'SIGTERM']) {
     process.on(signal, () => child.kill(signal));
@@ -133,7 +167,9 @@ async function main() {
     return;
   }
 
-  const { file, browser } = args;
+  const { file, browser, folderImport } = args;
+  const app = folderApp(process.cwd());
+  const importing = await wantsImport(app, file, folderImport);
   const { version } = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
   void sendTelemetry({
     home: homedir(),
@@ -152,8 +188,13 @@ async function main() {
   const server = spawn(process.execPath, [realpathSync(join(dir, 'scripts/local.mjs')), file, `--port=${port}`], { stdio: 'inherit', env });
   forward(server);
 
+  await whenReady(url);
   if (browser === 'open') {
-    await openWhenReady(url);
+    openBrowser(url);
+  }
+
+  if (importing) {
+    await importFolder(url, app).catch((error) => console.error(`feega: ${error.message}`));
   }
 }
 

package/launcher.mjs

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, readdirSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
 import { createServer } from 'node:net';
 import { join, resolve } from 'node:path';
 
@@ -7,8 +7,15 @@ const DEFAULT_PORT = 0;
 export const LOOPBACK = '127.0.0.1';
 export const MCP_PORT = 5173;
 export const MCP_ENTRY = 'mcp.mjs';
-export const USAGE = `usage: feega [file.feega] [--port <n>] [--no-open] [--help] [--version]
+export const USAGE = `usage: feega [file.feega] [--port <n>] [--no-open] [--import | --no-import] [--help] [--version]
        feega mcp [--port <n>]   MCP server (stdio) for the local feega on that port (default ${MCP_PORT})`;
+export const FolderImport = { Ask: 'ask', Yes: 'yes', No: 'no' };
+export const ImportStep = { Ask: 'ask', Import: 'import', Skip: 'skip' };
+
+const IMPORT_FLAGS = { '--import': FolderImport.Yes, '--no-import': FolderImport.No };
+const HOME_ROUTE = '/';
+const PLACE = /\/p\/([^/]+)\/c\/([^/?#]+)/;
+
 const CACHED_MARKER = '.complete';
 const APP_TAG = 'app-v';
 const RELEASES = 'https://github.com/andreabuttarelli/feega/releases/download';
@@ -61,6 +68,7 @@ export function parseArgs(argv, cwd) {
   const files = [];
   let port = DEFAULT_PORT;
   let browser = 'open';
+  let folderImport = FolderImport.Ask;
 
   while (rest.length) {
     const arg = rest.shift();
@@ -77,6 +85,11 @@ export function parseArgs(argv, cwd) {
       continue;
     }
 
+    if (IMPORT_FLAGS[arg]) {
+      folderImport = IMPORT_FLAGS[arg];
+      continue;
+    }
+
     const flagged = portFlag(arg, rest);
     if (flagged !== null) {
       port = flagged;
@@ -90,7 +103,7 @@ export function parseArgs(argv, cwd) {
     files.push(arg);
   }
 
-  return { command: 'run', file: resolve(cwd, files[0] ?? DEFAULT_FILE), port, browser };
+  return { command: 'run', file: resolve(cwd, files[0] ?? DEFAULT_FILE), port, browser, folderImport };
 }
 
 export const appDir = (home, version) => join(home, '.feega', 'app', version);
@@ -153,3 +166,46 @@ export const freePort = (port) =>
       probe.close(() => done(bound));
     });
   });
+
+export function folderApp(dir) {
+  const manifest = join(dir, 'package.json');
+  if (!existsSync(manifest)) {
+    return null;
+  }
+
+  try {
+    return JSON.parse(readFileSync(manifest, 'utf8')).scripts?.dev ? dir : null;
+  } catch {
+    return null;
+  }
+}
+
+const STEPS = {
+  [FolderImport.No]: () => ImportStep.Skip,
+  [FolderImport.Yes]: () => ImportStep.Import,
+  [FolderImport.Ask]: ({ fileExists, tty }) => (!fileExists && tty ? ImportStep.Ask : ImportStep.Skip)
+};
+
+export function importStep({ mode, app, fileExists, tty }) {
+  if (!app) {
+    return ImportStep.Skip;
+  }
+
+  return STEPS[mode]({ fileExists, tty });
+}
+
+export function placeOf(location) {
+  const found = PLACE.exec(location ?? '');
+  return found ? { projectId: found[1], canvasId: found[2] } : null;
+}
+
+export const importAsk = (place, folder) => ({
+  path: `/api/v1/projects/${place.projectId}/code-import`,
+  body: { canvasId: place.canvasId, folder, routes: [HOME_ROUTE], x: 0, y: 0 }
+});
+
+const HTTP_ERROR_MIN = 400;
+
+export const readyProbe = { redirect: 'manual' };
+
+export const served = (status) => status < HTTP_ERROR_MIN;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "feega",
-  "version": "0.1.27",
+  "version": "0.1.29",
   "description": "Run feega's infinite canvas locally, saved to a .feega file. No account, no database.",
   "license": "Apache-2.0",
   "type": "module",