layero 0.6.0 → 0.6.1

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.
@@ -98,6 +99,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

@@ -81,6 +81,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.")

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/package.json

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