layero 0.6.0 → 0.6.2

package/README.md

@@ -53,6 +53,7 @@ re-run `layero deploy`, get a new preview URL each time.
 | `layero deploy` | Auto-detect framework, pack cwd, build, ship. |
 | `layero deploys list` | List recent deploys. |
 | `layero rollback` | Re-activate the previous successful deploy. |
+| `layero hooks list/create/delete` | Manage deploy hooks (URL tokens that trigger builds from CMS / cron / external CI). |
 | `layero token` | Manage the auth token directly. |
 
 Run `layero <cmd> --help` for full options.
@@ -70,6 +71,12 @@ Run `layero <cmd> --help` for full options.
   uses that explicit path. Use this for CI flows that build in the
   pipeline, Webflow / Framer exports, or whenever you don't want the
   platform to run install/build for you.
+- `--root <dir>` — monorepo: tell the builder the app lives in a
+  subdirectory of the repo (e.g. `--root apps/web`). Saved on the
+  project; future GitHub-push and hook triggers use the same value.
+  CLI auto-detect honours it: framework signals are looked up inside
+  `<cwd>/<root>` so a `package.json` workspace at the repo root
+  doesn't shadow the real app's stack.
 - `--name <name>` — project name (only on first deploy).
 - `--project <id_or_slug>` — deploy into an existing project, ignoring
   `./.layero/project.json` (useful for CI).
@@ -91,6 +98,7 @@ Run `layero <cmd> --help` for full options.
 | `gatsby` dep | gatsby | `npm run build` | `public` |
 | `astro` dep / `astro.config.*` | astro | `npm run build` | `dist` |
 | `@docusaurus/core` dep / `docusaurus.config.*` | docusaurus | `npm run build` | `build` |
+| `@storybook/*` dep / `scripts.build-storybook` / `.storybook/main.*` | storybook | `npm run build-storybook` (or `npx storybook build`) | `storybook-static` |
 | `vitepress` dep / `.vitepress/config.*` / `docs/.vitepress/config.*` | vitepress | `npm run docs:build` (or `npx vitepress build`) | `.vitepress/dist` or `docs/.vitepress/dist` |
 | `vite` dep / `vite.config.*` | vite | `npm run build` | `dist` |
 | `react-scripts` dep | cra | `npm run build` | `build` |
@@ -98,6 +106,29 @@ Run `layero <cmd> --help` for full options.
 | `hugo.{toml,yaml,json}` or `config.*` with Hugo markers (`baseURL`, `[markup]`, …) | hugo | `hugo --gc --minify` (no install needed) | `public` |
 | any `.html` at root, no `package.json` | static | `true` (no-op) | `.` |
 
+## Deploy hooks — webhook URLs that trigger builds
+
+When something *other than you* should kick a build — a headless CMS
+publishing content, a cron job, an external CI pipeline — create a
+deploy hook. You get back an opaque URL; whoever POSTs to it fires a
+deploy.
+
+```bash
+# Inside a linked project directory:
+layero hooks create strapi-content          # preview-target, default branch
+layero hooks create publish --prod          # production-target hook
+layero hooks create staging --branch=dev    # explicit branch
+layero hooks list
+layero hooks delete <id>                    # revoke immediately
+```
+
+The created URL looks like `https://api.layero.ru/hooks/<token>`. Paste
+it into Strapi / Sanity / Contentful / Decap CMS / GitHub Actions / a
+cron job — any tool that can POST to a URL. Token = credential; rotate
+by `delete` + `create`. There is no per-token rate limit yet; rely on
+the platform's natural in-flight-commit dedup if the same commit gets
+fired more than once.
+
 ## Bring-your-own-build (`--prebuilt`)
 
 If you already build your site yourself — in CI, via a desktop tool like

package/dist/api.js

@@ -68,6 +68,9 @@ export class ApiClient {
     completeSetup(projectId, input) {
         return this.request("POST", `/projects/${projectId}/setup`, input);
     }
+    updateProject(projectId, input) {
+        return this.request("PATCH", `/projects/${projectId}`, input);
+    }
     triggerDeploy(projectId, input) {
         return this.request("POST", `/projects/${projectId}/deploy`, input);
     }
@@ -81,6 +84,15 @@ export class ApiClient {
     rollbackProject(projectId, input) {
         return this.request("POST", `/projects/${projectId}/rollback`, input);
     }
+    listDeployHooks(projectId) {
+        return this.request("GET", `/projects/${projectId}/deploy-hooks`);
+    }
+    createDeployHook(projectId, input) {
+        return this.request("POST", `/projects/${projectId}/deploy-hooks`, input);
+    }
+    deleteDeployHook(projectId, hookId) {
+        return this.request("DELETE", `/projects/${projectId}/deploy-hooks/${hookId}`);
+    }
     startDeviceAuth() {
         return this.request("POST", "/auth/cli/device");
     }

package/dist/bin/layero.js

@@ -11,6 +11,7 @@ import { linkCmd } from "../commands/link.js";
 import { tokenSetCmd } from "../commands/token.js";
 import { deployCmd } from "../commands/deploy.js";
 import { deploysListCmd, rollbackCmd } from "../commands/deploys.js";
+import { hooksCreateCmd, hooksDeleteCmd, hooksListCmd } from "../commands/hooks.js";
 import { loginCmd } from "../commands/login.js";
 import { orgsListCmd } from "../commands/orgs.js";
 import { initCmd } from "../commands/init.js";
@@ -74,6 +75,55 @@ async function main() {
         .action(async (opts) => {
         await deploysListCmd(opts);
     });
+    const hooks = program
+        .command("hooks")
+        .description("Manage deploy hooks — URL tokens that trigger builds from CMS / cron / external CI.");
+    hooks
+        .command("list")
+        .description("List deploy hooks for the linked project.")
+        .option("--project <id>", "target project id (default: linked .layero/project.json)")
+        .action(async (opts) => {
+        try {
+            await hooksListCmd(opts);
+        }
+        catch (err) {
+            console.error(String(err?.message ?? err));
+            process.exitCode = 1;
+        }
+    });
+    hooks
+        .command("create <name>")
+        .description("Create a new deploy hook. Prints a URL — paste it into Strapi / Sanity / "
+        + "Contentful / GitHub Actions / cron as a POST webhook.")
+        .option("--project <id>", "target project id (default: linked .layero/project.json)")
+        .option("--branch <name>", "branch to deploy when fired (default: project default_branch, evaluated at fire time)")
+        .option("--prod", "fire the hook against the production environment (default: preview)")
+        .addHelpText("after", "\nExamples:\n"
+        + "  $ layero hooks create strapi-content        # preview-target hook for default branch\n"
+        + "  $ layero hooks create publish --prod        # production-target hook for default branch\n"
+        + "  $ layero hooks create staging --branch=dev  # any branch, preview environment")
+        .action(async (name, opts) => {
+        try {
+            await hooksCreateCmd(name, opts);
+        }
+        catch (err) {
+            console.error(String(err?.message ?? err));
+            process.exitCode = 1;
+        }
+    });
+    hooks
+        .command("delete <id>")
+        .description("Revoke a deploy hook. The URL stops working immediately.")
+        .option("--project <id>", "target project id (default: linked .layero/project.json)")
+        .action(async (id, opts) => {
+        try {
+            await hooksDeleteCmd(id, opts);
+        }
+        catch (err) {
+            console.error(String(err?.message ?? err));
+            process.exitCode = 1;
+        }
+    });
     program
         .command("rollback")
         .description("Re-activate the previous successful deploy on the project's default branch.")
@@ -104,12 +154,13 @@ async function main() {
     program
         .command("deploy")
         .description("Pack the current directory and deploy it. Framework, build command and output directory are auto-detected.")
-        .option("-t, --type <preset>", "framework override (vite | vitepress | next | astro | cra | sveltekit | nuxt | gatsby | docusaurus | eleventy | hugo | static)")
+        .option("-t, --type <preset>", "framework override (vite | vitepress | next | astro | cra | sveltekit | nuxt | gatsby | docusaurus | storybook | eleventy | hugo | static)")
         .option("--name <name>", "project name (only used on first deploy)")
         .option("--project <id_or_slug>", "deploy into an existing project, ignoring local config")
         .option("-y, --yes", "non-interactive: accept defaults and skip --prod confirmation")
         .option("--config", "(legacy alias of the default behaviour — auto-detect + .layero/project.json values)")
         .option("--prebuilt [dir]", "ship an already-built artifact directory (default auto-pick: dist/build/public/out/_site/...)")
+        .option("--root <dir>", "monorepo: subdirectory inside the repo that the builder treats as the app root (saved on the project; future GitHub-push and hook triggers use the same value)")
         .option("--prod", "deploy to production (replaces apex_hostname's active deploy). Without this flag, deploys go to the project's CLI preview pseudo-branch.")
         .option("--branch <name>", "deploy to a specific branch's environment. Wins over --prod.")
         .option("--org <slug>", "Layero organization slug for first-time project creation. Defaults to personal; required when you're a member of multiple orgs and want a non-personal home.")

package/dist/commands/deploy.js

@@ -26,6 +26,7 @@ const VALID_TYPES = new Set([
     "eleventy",
     "11ty",
     "vitepress",
+    "storybook",
 ]);
 function dashboardOrigin(apiUrl) {
     const override = process.env.LAYERO_DASHBOARD_URL;
@@ -201,7 +202,11 @@ async function resolvePrebuiltDir(cwd, raw) {
 // Resolve the framework / build / output config to send to completeSetup.
 // Precedence: explicit CLI args > .layero/project.json > auto-detect.
 async function resolveSetupConfig(cwd, opts, existing) {
-    const detected = await detectProject(cwd);
+    // Honour --root when auto-detecting: the framework signals live in the
+    // monorepo subdir, not the repo root. Without this the detector sees
+    // a bare workspace package.json and falls through to "static".
+    const detectCwd = opts.root ? path.join(cwd, opts.root) : cwd;
+    const detected = await detectProject(detectCwd);
     emit({
         event: "detected",
         framework: detected.framework_hint,
@@ -298,9 +303,15 @@ export async function deployCmd(opts) {
             output_dir: setup.output_dir,
             analytics_enabled: persistedCfg.analytics_enabled ?? false,
             env_vars: persistedCfg.env_vars ?? {},
+            root_directory: opts.root ?? null,
         });
         emit({ event: "setup_applied" });
     }
+    else if (opts.root !== undefined) {
+        // Active project: --root patches the existing row so the *next*
+        // GitHub-pushed or hook-triggered build uses the new subdir.
+        project = await api.updateProject(project.id, { root_directory: opts.root });
+    }
     let upload = null;
     try {
         upload = await packAndUpload(api, cwd, project, prebuiltDir);

package/dist/commands/hooks.js

@@ -0,0 +1,80 @@
+import chalk from "chalk";
+import { ApiClient, ApiError } from "../api.js";
+import { loadConfig } from "../config.js";
+import { loadProjectConfig } from "../project-config.js";
+async function resolveProjectId(opts) {
+    if (opts.project) {
+        // Accepts an id directly; UUID format check is server-side.
+        return opts.project;
+    }
+    const linked = await loadProjectConfig(process.cwd());
+    if (linked?.project_id) {
+        return linked.project_id;
+    }
+    throw new Error("no project linked in cwd — pass --project <id> or run `layero deploy` "
+        + "from a project directory once to link it.");
+}
+async function makeClient() {
+    const cfg = await loadConfig();
+    if (!cfg.token) {
+        throw new Error("not logged in. run `layero login` first.");
+    }
+    return new ApiClient(cfg);
+}
+export async function hooksListCmd(opts) {
+    const api = await makeClient();
+    const projectId = await resolveProjectId(opts);
+    const hooks = await api.listDeployHooks(projectId);
+    if (hooks.length === 0) {
+        console.log("no deploy hooks yet — `layero hooks create <name>` to add one.");
+        return;
+    }
+    for (const h of hooks) {
+        const targetTag = h.target === "production" ? chalk.red("[prod]") : chalk.cyan("[preview]");
+        const branchTag = h.branch ? chalk.dim(`branch=${h.branch}`) : chalk.dim("branch=default");
+        const last = h.last_triggered_at
+            ? `fired ${new Date(h.last_triggered_at).toISOString()}`
+            : "never fired";
+        console.log(`${targetTag} ${chalk.bold(h.name)}  ${branchTag}  ${chalk.dim("(" + last + ")")}`);
+        console.log(`        ${chalk.dim(h.id)}`);
+        console.log(`        ${h.url}`);
+    }
+}
+export async function hooksCreateCmd(name, opts) {
+    if (!name || !name.trim()) {
+        throw new Error("name is required: `layero hooks create <name>`");
+    }
+    const api = await makeClient();
+    const projectId = await resolveProjectId(opts);
+    const hook = await api.createDeployHook(projectId, {
+        name: name.trim(),
+        branch: opts.branch ?? null,
+        target: opts.prod ? "production" : "preview",
+    });
+    const targetTag = hook.target === "production" ? chalk.red("[prod]") : chalk.cyan("[preview]");
+    console.log(`${chalk.green("✓")} created ${targetTag} ${chalk.bold(hook.name)}`);
+    console.log(`  ${chalk.dim(hook.id)}`);
+    console.log(`  ${chalk.bold(hook.url)}`);
+    console.log(chalk.dim("\n  Paste this URL into your CMS / cron / external CI as a POST webhook. "
+        + "Anyone with the URL can fire a build — treat it like a secret. "
+        + "Rotate by deleting and creating a new one."));
+}
+export async function hooksDeleteCmd(hookId, opts) {
+    if (!hookId) {
+        throw new Error("hook id is required: `layero hooks delete <id>`");
+    }
+    const api = await makeClient();
+    const projectId = await resolveProjectId(opts);
+    try {
+        await api.deleteDeployHook(projectId, hookId);
+    }
+    catch (err) {
+        if (err instanceof ApiError && err.status === 404) {
+            console.error(chalk.yellow(`no hook ${hookId} on this project (already deleted?)`));
+            process.exitCode = 1;
+            return;
+        }
+        throw err;
+    }
+    console.log(`${chalk.green("✓")} hook ${chalk.dim(hookId)} revoked`);
+}

package/dist/detect.js

@@ -115,6 +115,46 @@ export async function detectProject(cwd) {
                 confident: true,
             };
         }
+        // Storybook before Vite/CRA: Storybook 7+ uses Vite or webpack
+        // internally, so `vite` / `react-scripts` is in deps. Without
+        // listing it first the SPA Vite path would output_dir=dist, which
+        // doesn't exist after `build-storybook`.
+        const storybookDeps = [
+            "@storybook/cli",
+            "@storybook/react",
+            "@storybook/react-vite",
+            "@storybook/react-webpack5",
+            "@storybook/vue",
+            "@storybook/vue3",
+            "@storybook/vue3-vite",
+            "@storybook/svelte",
+            "@storybook/svelte-vite",
+            "@storybook/web-components",
+            "@storybook/web-components-vite",
+            "@storybook/preact",
+            "@storybook/angular",
+            "@storybook/nextjs",
+            "@storybook/html",
+            "@storybook/html-vite",
+            "storybook",
+        ];
+        const hasStorybookDep = storybookDeps.some((d) => hasDep(pkg, d));
+        const hasStorybookScript = pkg.scripts?.["build-storybook"] !== undefined
+            || Object.values(pkg.scripts ?? {}).some((s) => typeof s === "string" && s.includes("storybook build"));
+        const hasStorybookDir = await fileExists(cwd, ".storybook/main.js", ".storybook/main.ts", ".storybook/main.cjs", ".storybook/main.mjs");
+        if (hasStorybookDep || hasStorybookScript || hasStorybookDir) {
+            const cmd = pkg.scripts?.["build-storybook"]
+                ? "npm run build-storybook"
+                : (pkg.scripts?.build && pkg.scripts.build.includes("storybook"))
+                    ? "npm run build"
+                    : "npx storybook build";
+            return {
+                framework_hint: "storybook",
+                build_cmd: cmd,
+                output_dir: "storybook-static",
+                confident: true,
+            };
+        }
         // VitePress before generic Vite: VitePress repos often pull `vite`
         // transitively, and the SPA Vite path would set output_dir=dist —
         // wrong for VitePress, which writes to `.vitepress/dist/` (or

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "layero",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Layero CLI — publish a local site with one command. No git, no GitHub, agent-friendly (Cursor, Claude Code).",
   "license": "MIT",
   "type": "module",