novence 0.1.1 → 0.1.3

package/README.md

@@ -34,6 +34,7 @@ Requires Node 18+.
 ```bash
 novence deploy              # auto-detects dist, build, out, public, _site
 novence deploy ./site       # or point at a directory
+novence deploy report.html  # one HTML file (dashboard, report, artifact)
 ```
 
 First run with no stored key publishes anonymously (no email), stores

package/dist/commands/deploy.js

@@ -1,5 +1,5 @@
-import { existsSync, statSync } from "node:fs";
-import { resolve } from "node:path";
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { basename, resolve } from "node:path";
 import { Novence } from "@novence/sdk";
 import { claimAndMaybeVerify, ensureApiKey } from "../lib/auth.js";
 import { resolveApiBase } from "../lib/config.js";
@@ -11,26 +11,34 @@ const POLL_TIMEOUT_MS = 5 * 60 * 1000;
 const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
 /** Common build output directories, checked in order when no dir is given. */
 const CANDIDATE_DIRS = ["dist", "build", "out", "public", "_site"];
-function resolveSiteDir(explicit) {
+function resolveSiteSource(explicit) {
     if (explicit) {
-        const dir = resolve(explicit);
-        if (!existsSync(dir) || !statSync(dir).isDirectory())
-            fail(`Not a directory: ${dir}`);
-        return dir;
+        const target = resolve(explicit);
+        if (!existsSync(target))
+            fail(`Not found: ${target}`);
+        const st = statSync(target);
+        if (st.isFile()) {
+            if (!target.toLowerCase().endsWith(".html")) {
+                fail(`Not a directory or .html file: ${target}`);
+            }
+            return { kind: "html", path: target };
+        }
+        if (!st.isDirectory())
+            fail(`Not a directory: ${target}`);
+        return { kind: "dir", path: target };
     }
     for (const candidate of CANDIDATE_DIRS) {
         const dir = resolve(process.cwd(), candidate);
         if (existsSync(dir) && statSync(dir).isDirectory())
-            return dir;
+            return { kind: "dir", path: dir };
     }
     return fail(`No build output found. Looked for ${CANDIDATE_DIRS.join(", ")} in ${process.cwd()}.\n` +
-        "  Pass one explicitly:  novence deploy ./your-dir");
+        "  Pass a directory or an HTML file:  novence deploy ./your-dir   or   novence deploy report.html");
 }
-async function publish(client, projectId) {
+async function waitUntilLive(client, projectId) {
     const spinner = spin("Publishing…");
     const startedAt = Date.now();
     try {
-        await client.deployments.create(projectId);
         let lastStatus = "";
         while (Date.now() - startedAt < POLL_TIMEOUT_MS) {
             const { deployment } = await client.deployments.latest(projectId);
@@ -56,6 +64,10 @@ async function publish(client, projectId) {
     spinner.stop();
     return fail("Timed out after 5 minutes waiting for the deploy to go live.");
 }
+async function publish(client, projectId) {
+    await client.deployments.create(projectId);
+    return waitUntilLive(client, projectId);
+}
 function reportChecks(deployment) {
     const checks = deployment.checksResults;
     if (!checks)
@@ -72,19 +84,19 @@ function reportChecks(deployment) {
 }
 export async function deployCommand(args) {
     const apiBase = resolveApiBase(flagString(args.flags, "api"));
-    const siteDir = resolveSiteDir(args.positionals[0]);
-    if (!existsSync(resolve(siteDir, "index.html"))) {
-        fail(`${siteDir} has no index.html — a static site needs one at its root.`);
+    const source = resolveSiteSource(args.positionals[0]);
+    if (source.kind === "dir" && !existsSync(resolve(source.path, "index.html"))) {
+        fail(`${source.path} has no index.html — a static site needs one at its root.`);
     }
     let projectId = flagString(args.flags, "project");
     try {
-        await runDeploy(args, apiBase, siteDir);
+        await runDeploy(args, apiBase, source);
     }
     catch (err) {
         fail(explain(err, { apiBase, projectId }));
     }
 }
-async function runDeploy(args, apiBase, siteDir) {
+async function runDeploy(args, apiBase, source) {
     const interactive = !isJsonMode() && !flagBool(args.flags, "no-input");
     const creds = await ensureApiKey({
         apiBase,
@@ -94,20 +106,44 @@ async function runDeploy(args, apiBase, siteDir) {
     const client = new Novence({ apiKey: creds.apiKey, baseUrl: apiBase });
     let projectId = flagString(args.flags, "project");
     let projectUrl;
-    if (projectId) {
-        const { project } = await client.projects.get(projectId);
-        projectUrl = project.url;
-        step(`Reusing project ${project.name} (${project.suffix})`);
+    let fileCount = 1;
+    let deployment;
+    if (source.kind === "html") {
+        const html = readFileSync(source.path, "utf8");
+        const defaultName = basename(source.path).replace(/\.html?$/i, "") || "artifact";
+        const name = flagString(args.flags, "name") ?? defaultName;
+        const published = await withSpin(`Publishing ${source.path}…`, () => client.publishHtml({
+            html,
+            title: name,
+            projectId,
+        }), (result) => (result.created ? "Created project" : "Updated project"));
+        projectId = published.projectId;
+        projectUrl = published.url;
+        if (!projectId)
+            fail("Missing project id");
+        const htmlProjectId = projectId;
+        deployment = await waitUntilLive(client, htmlProjectId);
     }
     else {
-        const name = flagString(args.flags, "name") ?? "site";
-        const created = await client.projects.create({ name });
-        projectId = created.project.id;
-        projectUrl = created.url;
-        step(`Created project ${name} (${created.project.suffix})`);
+        if (projectId) {
+            const { project } = await client.projects.get(projectId);
+            projectUrl = project.url;
+            step(`Reusing project ${project.name} (${project.suffix})`);
+        }
+        else {
+            const name = flagString(args.flags, "name") ?? "site";
+            const created = await client.projects.create({ name });
+            projectId = created.project.id;
+            projectUrl = created.url;
+            step(`Created project ${name} (${created.project.suffix})`);
+        }
+        if (!projectId)
+            fail("Missing project id");
+        const dirProjectId = projectId;
+        const { uploaded } = await withSpin(`Uploading ${source.path}…`, () => client.files.uploadDir(dirProjectId, source.path), ({ uploaded: files }) => `Uploaded ${files.length} file${files.length === 1 ? "" : "s"}`);
+        fileCount = uploaded.length;
+        deployment = await publish(client, dirProjectId);
     }
-    const { uploaded } = await withSpin(`Uploading ${siteDir}…`, () => client.files.uploadDir(projectId, siteDir), ({ uploaded: files }) => `Uploaded ${files.length} file${files.length === 1 ? "" : "s"}`);
-    const deployment = await publish(client, projectId);
     if (deployment.status === "failed") {
         if (isJsonMode()) {
             json({ ok: false, projectId, status: deployment.status, error: deployment.errorMessage });
@@ -117,6 +153,8 @@ async function runDeploy(args, apiBase, siteDir) {
     }
     reportChecks(deployment);
     const liveUrl = siteUrl(deployment.liveUrl ?? projectUrl);
+    const previewUrl = deployment.previewUrl ? siteUrl(deployment.previewUrl) : null;
+    const distinctPreview = previewUrl && previewUrl !== liveUrl ? previewUrl : null;
     if (isJsonMode()) {
         json({
             ok: true,
@@ -124,11 +162,14 @@ async function runDeploy(args, apiBase, siteDir) {
             deploymentId: deployment.id,
             status: deployment.status,
             url: liveUrl,
-            files: uploaded.length,
+            ...(distinctPreview ? { previewUrl: distinctPreview } : {}),
+            files: fileCount,
             checks: deployment.checksResults ?? null,
         });
         return;
     }
+    if (distinctPreview)
+        step(`Preview  ${distinctPreview}`);
     // Last line, alone, so it pipes cleanly.
     result(liveUrl);
     if (creds.anonymous && interactive) {

package/dist/commands/rollback.d.ts

@@ -0,0 +1,2 @@
+import { type ParsedArgs } from "../lib/args.js";
+export declare function rollbackCommand(args: ParsedArgs): Promise<void>;

package/dist/commands/rollback.js

@@ -0,0 +1,46 @@
+import { Novence } from "@novence/sdk";
+import { loadApiKey, resolveApiBase } from "../lib/config.js";
+import { flagString } from "../lib/args.js";
+import { explain } from "../lib/errors.js";
+import { fail, isJsonMode, json, result, siteUrl, step } from "../lib/ui.js";
+export async function rollbackCommand(args) {
+    const apiBase = resolveApiBase(flagString(args.flags, "api"));
+    const apiKey = loadApiKey();
+    if (!apiKey)
+        fail("Not signed in. Run `novence login`.");
+    const client = new Novence({ apiKey, baseUrl: apiBase });
+    const wanted = flagString(args.flags, "project") ?? args.positionals[0];
+    const deploymentId = flagString(args.flags, "deployment");
+    let projectId = wanted;
+    try {
+        if (!projectId) {
+            const { projects } = await client.projects.list();
+            if (projects.length === 0)
+                fail("No projects yet. Run `novence deploy ./dist`.");
+            projectId = projects[0].id;
+        }
+        const { deployment } = await client.deployments.rollback(projectId, {
+            ...(deploymentId ? { deploymentId } : {}),
+        });
+        const liveUrl = siteUrl(deployment.liveUrl ?? deployment.previewUrl ?? "");
+        const previewUrl = deployment.previewUrl ? siteUrl(deployment.previewUrl) : null;
+        if (isJsonMode()) {
+            json({
+                ok: true,
+                projectId,
+                deploymentId: deployment.id,
+                status: deployment.status,
+                url: liveUrl,
+                ...(previewUrl && previewUrl !== liveUrl ? { previewUrl } : {}),
+            });
+            return;
+        }
+        step("Restored previous snapshot (HTML cache ~60s; hard-refresh if the old page lingers).");
+        if (previewUrl && previewUrl !== liveUrl)
+            step(`Preview  ${previewUrl}`);
+        result(liveUrl);
+    }
+    catch (err) {
+        fail(explain(err, { apiBase, projectId: wanted }));
+    }
+}

package/dist/index.js

@@ -15,11 +15,13 @@ import { openCommand } from "./commands/open.js";
 import { domainsCommand } from "./commands/domains.js";
 import { keysCommand } from "./commands/keys.js";
 import { checksCommand } from "./commands/checks.js";
+import { rollbackCommand } from "./commands/rollback.js";
 const HELP = `
   novence — deploy a static site to the edge
 
   Usage
-    novence deploy [dir]        Upload a directory and publish it live
+    novence deploy [dir|file]   Upload a directory or one .html file and publish it live
+    novence rollback            Restore the previous live snapshot (Pro/Scale)
     novence open [project]      Open a project's live URL
     novence checks [project]    Quality-gate results for the latest deploy
     novence domains add <host>  Attach a custom domain (prints DNS records)
@@ -34,10 +36,16 @@ const HELP = `
   Deploy
     novence deploy              Auto-detects dist, build, out, public, _site
     novence deploy ./site       Deploy a specific directory
+    novence deploy report.html  Publish a single HTML file as the site
     --name <name>               Project name (default: "site")
     --project <id>              Redeploy an existing project
     --email <email>             Skip the email prompt on first run (bootstrap instead of demo)
 
+  Rollback (Pro/Scale)
+    novence rollback            Restore the previous live snapshot
+    --project <id>              Project (default: first in the list)
+    --deployment <id>           Specific retained deploy (last 5)
+
   Global
     --json                      Machine-readable output (implies --no-input)
     --no-input                  Never prompt; fail instead
@@ -83,6 +91,7 @@ async function main() {
         ls: [],
         login: ["email", "recover"],
         whoami: [],
+        rollback: ["project", "deployment"],
     };
     const allowed = ALLOWED[args.command];
     if (allowed) {
@@ -110,6 +119,8 @@ async function main() {
             return projectsCommand(args);
         case "whoami":
             return whoamiCommand(args);
+        case "rollback":
+            return rollbackCommand(args);
         default:
             fail(`Unknown command: ${args.command}\n  Run \`novence --help\` for usage.`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "novence",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "CLI for Novence — deploy a static site to the edge in one command.",
   "license": "MIT",
   "type": "module",
@@ -40,7 +40,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@novence/sdk": "^0.2.3"
+    "@novence/sdk": "^0.2.5"
   },
   "devDependencies": {
     "@types/node": "^22.10.2",