hypurrcloud 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,120 @@
-# Temporary Holding Version
+# hypurrcloud
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Command-line interface for [HypurrCloud](https://hypurrcloud-prod.mdmushtaq.online) deploys and site management.
+
+Requires **Node.js 20+**.
+
+## Install
+
+```bash
+npm install -g hypurrcloud
+```
+
+Or run without installing:
+
+```bash
+npx hypurrcloud@0.1.0 --help
+```
+
+## Authentication
+
+Create a personal access token in the dashboard under **Settings → API tokens** (`/settings/tokens`). Tokens use the `hc_live_` prefix.
+
+### Interactive login
+
+```bash
+hypurrcloud login
+hypurrcloud login --api https://api.your-host.example
+```
+
+Credentials are saved to `~/.hypurrcloud` (JSON with `api` and `token`). The token is never printed by the CLI.
+
+### Environment variables
+
+| Variable | Description |
+|----------|-------------|
+| `HYPURRCLOUD_API` | API origin (no trailing slash), e.g. `https://api.your-host.example` |
+| `HYPURRCLOUD_TOKEN` | Bearer token (`hc_live_…`) |
+
+Environment variables override the config file. Use `hypurrcloud env` to see whether an API URL and token are configured (token value is not shown).
+
+### Token scopes
+
+| Scope | Typical CLI use |
+|-------|-----------------|
+| `read` | `me`, `sites list`, `projects list/get`, `deployments list/get`, `github status` |
+| `deploy` | `deploy`, `projects deploy/dispatch`, `promote`, `rollback`, `github install` |
+| `full` | Grants `read`, `deploy`, `sites:write`, and `domains:write` for API routes that accept those scopes |
+
+API tokens cannot access dashboard-only routes (billing, token management, admin).
+
+## Exit codes
+
+| Code | Meaning |
+|------|---------|
+| `0` | Success |
+| `1` | Deploy or API failure (including insufficient scope, HTTP 4xx/5xx except auth) |
+| `2` | Usage / invalid arguments |
+| `3` | Authentication failure (missing token, invalid, expired, or HTTP 401) |
+
+## Commands
+
+Run `hypurrcloud --help` for a short usage summary.
+
+```text
+hypurrcloud login [--api <url>]
+hypurrcloud me [--json]
+hypurrcloud env
+hypurrcloud deploy <directory> --site <slug> [--project <id>] [--preview] [--include-dotfiles] [--json]
+hypurrcloud sites list [--json]
+hypurrcloud projects list [--json]
+hypurrcloud projects get <projectId> [--json]
+hypurrcloud projects deploy <projectId> [--json]
+hypurrcloud projects dispatch <projectId> [--json]
+hypurrcloud deployments list [--site <slug>] [--json]
+hypurrcloud deployments get <deploymentId> [--json]
+hypurrcloud promote <deploymentId> [--json]
+hypurrcloud rollback <deploymentId> [--json]
+hypurrcloud github status [--json]
+hypurrcloud github install [--json]
+```
+
+Global flag: `--api <url>` overrides the API origin for a single invocation.
+
+### Examples
+
+```bash
+hypurrcloud me
+hypurrcloud sites list --json
+hypurrcloud deploy ./dist --site my-site --preview
+hypurrcloud projects deploy <project-uuid>
+```
+
+PowerShell:
+
+```powershell
+hypurrcloud deploy .\dist --site my-site
+$env:HYPURRCLOUD_API = "https://api.your-host.example"
+$env:HYPURRCLOUD_TOKEN = "hc_live_..."
+hypurrcloud me
+echo Exit code: $LASTEXITCODE
+```
+
+### Standalone vs GitHub-linked sites
+
+- **Standalone (ZIP):** `deploy ./dist --site <slug>` uploads files to `POST /api/sites/deploy`.
+- **GitHub project:** The CLI detects a linked site and calls `projects deploy` or `projects dispatch` instead. The local directory is not uploaded for repository-backed deploys.
+
+## JSON output
+
+Pass `--json` on supported commands. Successful responses are written to **stdout** as JSON. With `--json`, errors are also written to stdout as `{"error":"…","details":{…}}` when the API returns a JSON body; a short message may still appear on stderr.
+
+`hypurrcloud env` always prints JSON (`api`, `tokenConfigured`).
+
+## GitHub Actions
+
+See the [deploy-action README](../deploy-action/README.md) in this repository. The action runs `npx hypurrcloud@0.1.0 deploy … --json` with `HYPURRCLOUD_TOKEN` and optional `HYPURRCLOUD_API`.
+
+## License
+
+MIT

package/bin/hypurrcloud.js

@@ -0,0 +1,304 @@
+#!/usr/bin/env node
+import readline from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import path from "node:path";
+import { Blob } from "node:buffer";
+import { resolveConfig, saveConfigFile, defaultApiForHost, loadConfigFile } from "../lib/config.js";
+import { apiRequest, EXIT, finishWithExitCode } from "../lib/http.js";
+import { walkDirectory } from "../lib/zip.js";
+
+function parseFlags(argv) {
+  const flags = { json: false, preview: false, includeDotfiles: false, site: "", project: "", api: "", help: false };
+  const positional = [];
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "--help" || arg === "-h") flags.help = true;
+    else if (arg === "--json") flags.json = true;
+    else if (arg === "--preview") flags.preview = true;
+    else if (arg === "--include-dotfiles") flags.includeDotfiles = true;
+    else if (arg === "--site") flags.site = argv[++i] || "";
+    else if (arg === "--project") flags.project = argv[++i] || "";
+    else if (arg === "--api") flags.api = argv[++i] || "";
+    else positional.push(arg);
+  }
+  return { flags, positional };
+}
+
+function printJson(value) {
+  process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+}
+
+function usage() {
+  process.stderr.write(`Usage:
+  hypurrcloud [--help]
+  hypurrcloud login [--api <url>]
+  hypurrcloud me [--json]
+  hypurrcloud env
+  hypurrcloud deploy <directory> --site <slug> [--project <id>] [--preview] [--include-dotfiles] [--json]
+  hypurrcloud sites list [--json]
+  hypurrcloud projects list [--json]
+  hypurrcloud projects get <projectId> [--json]
+  hypurrcloud projects deploy <projectId> [--json]
+  hypurrcloud projects dispatch <projectId> [--json]
+  hypurrcloud deployments list [--site <slug>] [--json]
+  hypurrcloud deployments get <deploymentId> [--json]
+  hypurrcloud promote <deploymentId> [--json]
+  hypurrcloud rollback <deploymentId> [--json]
+  hypurrcloud github status [--json]
+  hypurrcloud github install [--json]
+`);
+}
+
+async function cmdLogin(flags) {
+  const file = loadConfigFile();
+  const api = flags.api || process.env.HYPURRCLOUD_API || file.api || defaultApiForHost();
+  const rl = readline.createInterface({ input, output });
+  const apiAnswer = (await rl.question(`API base URL [${api}]: `)).trim();
+  const chosenApi = (apiAnswer || api).replace(/\/$/, "");
+  process.stdout.write("Paste your API token (from Settings → API tokens): ");
+  const token = (await rl.question("")).trim();
+  rl.close();
+  if (!token.startsWith("hc_live_")) {
+    throw Object.assign(new Error("Token must start with hc_live_."), { code: EXIT.USAGE });
+  }
+  saveConfigFile({ api: chosenApi, token });
+  process.stdout.write(`Saved credentials to ~/.hypurrcloud\n`);
+}
+
+async function cmdMe(config, flags) {
+  const data = await apiRequest(config, "/api/me");
+  if (flags.json) printJson(data);
+  else process.stdout.write(`${data.email} (${data.plan})\n`);
+}
+
+async function cmdEnv(config) {
+  printJson({ api: config.api, tokenConfigured: Boolean(config.token) });
+}
+
+async function findProjectForSite(config, siteSlug, projectIdFlag) {
+  if (projectIdFlag) {
+    const data = await apiRequest(config, `/api/projects/${encodeURIComponent(projectIdFlag)}`);
+    return data.project;
+  }
+  const sitesData = await apiRequest(config, "/api/sites");
+  const site = (sitesData.sites || []).find((s) => s.id === siteSlug);
+  if (!site || (site.source !== "github-project" && !site.projectId)) return null;
+  const projectsData = await apiRequest(config, "/api/projects");
+  return (projectsData.projects || []).find((p) => p.siteId === siteSlug) || null;
+}
+
+function resolveDeploymentMethod(project) {
+  if (project.deploymentMethod) return project.deploymentMethod;
+  if (project.deploymentMode === "build") return "github_actions";
+  return "byo_artifact";
+}
+
+async function cmdProjectDeploy(config, flags, projectId) {
+  if (!projectId) throw Object.assign(new Error("projects deploy requires a project id."), { code: EXIT.USAGE });
+  const project = (await apiRequest(config, `/api/projects/${encodeURIComponent(projectId)}`)).project;
+  const method = resolveDeploymentMethod(project);
+  if (method === "github_actions" || method === "byo_runner") {
+    return cmdProjectDispatch(config, flags, projectId);
+  }
+  try {
+    const data = await apiRequest(config, `/api/projects/${encodeURIComponent(projectId)}/deploy`, { method: "POST" });
+    if (flags.json) printJson(data);
+    else process.stdout.write(`Deploy queued: ${data.deploymentUrl || data.deployment?.deploymentUrl || project.siteId}\n`);
+  } catch (error) {
+    error.code = error.code ?? EXIT.DEPLOY_FAILED;
+    throw error;
+  }
+}
+
+async function cmdProjectDispatch(config, flags, projectId) {
+  if (!projectId) throw Object.assign(new Error("projects dispatch requires a project id."), { code: EXIT.USAGE });
+  try {
+    const data = await apiRequest(config, `/api/projects/${encodeURIComponent(projectId)}/workflow/dispatch`, { method: "POST" });
+    if (flags.json) printJson(data);
+    else process.stdout.write(`Workflow dispatch queued: ${data.deployment?.id || "ok"}\n`);
+  } catch (error) {
+    error.code = error.code ?? EXIT.DEPLOY_FAILED;
+    throw error;
+  }
+}
+
+async function cmdDeploy(config, flags, directory) {
+  if (!flags.site) {
+    throw Object.assign(new Error("deploy requires a directory and --site <slug>."), { code: EXIT.USAGE });
+  }
+
+  const project = await findProjectForSite(config, flags.site, flags.project);
+  if (project) {
+    const method = resolveDeploymentMethod(project);
+    if (directory && !flags.json) {
+      process.stderr.write(`Note: GitHub project deploy uses the connected repository; local directory "${directory}" is not uploaded.\n`);
+    }
+    if (method === "github_actions" || method === "byo_runner") {
+      return cmdProjectDispatch(config, flags, project.id);
+    }
+    return cmdProjectDeploy(config, flags, project.id);
+  }
+
+  if (!directory) {
+    throw Object.assign(new Error("deploy requires a directory and --site <slug>."), { code: EXIT.USAGE });
+  }
+  const root = path.resolve(directory);
+  const files = walkDirectory(root, flags.includeDotfiles);
+  if (!files.length) {
+    throw Object.assign(new Error("No files to deploy after ignore rules."), { code: EXIT.USAGE });
+  }
+  const uploadForm = new FormData();
+  uploadForm.set("metadata", JSON.stringify({
+    siteName: flags.site,
+    siteId: flags.site,
+    source: "zip",
+    ...(flags.preview ? { preview: true } : {}),
+  }));
+  for (const entry of files) {
+    const content = await import("node:fs/promises").then((m) => m.readFile(entry.abs));
+    uploadForm.append("files", new Blob([content]), entry.rel);
+  }
+
+  try {
+    const data = await apiRequest(config, "/api/sites/deploy", { method: "POST", body: uploadForm });
+    if (flags.json) printJson(data);
+    else {
+      const url = data.previewUrl || data.deploymentUrl;
+      process.stdout.write(`Deploy OK: ${url}\n`);
+    }
+  } catch (error) {
+    error.code = error.code ?? EXIT.DEPLOY_FAILED;
+    throw error;
+  }
+}
+
+async function cmdSitesList(config, flags) {
+  const data = await apiRequest(config, "/api/sites");
+  if (flags.json) printJson(data);
+  else {
+    for (const site of data.sites || []) {
+      process.stdout.write(`${site.id}\t${site.name}\t${site.source || ""}\t${site.url}\n`);
+    }
+  }
+}
+
+async function cmdProjectsList(config, flags) {
+  const data = await apiRequest(config, "/api/projects");
+  if (flags.json) printJson(data);
+  else {
+    for (const p of data.projects || []) {
+      process.stdout.write(`${p.id}\t${p.siteId}\t${p.name}\t${p.repositoryFullName}\t${p.status}\n`);
+    }
+  }
+}
+
+async function cmdProjectsGet(config, flags, projectId) {
+  if (!projectId) throw Object.assign(new Error("projects get requires a project id."), { code: EXIT.USAGE });
+  const data = await apiRequest(config, `/api/projects/${encodeURIComponent(projectId)}`);
+  if (flags.json) printJson(data);
+  else {
+    const p = data.project;
+    process.stdout.write(`${p.id}\t${p.siteId}\t${p.name}\t${p.repositoryFullName}\t${resolveDeploymentMethod(p)}\n`);
+  }
+}
+
+async function cmdDeploymentsList(config, flags) {
+  const data = await apiRequest(config, "/api/deployments");
+  let deployments = data.deployments || [];
+  if (flags.site) deployments = deployments.filter((d) => d.siteId === flags.site);
+  if (flags.json) printJson({ deployments });
+  else {
+    for (const d of deployments) {
+      process.stdout.write(`${d.id}\t${d.siteId}\t${d.status}\t${d.previewUrl || d.deploymentUrl || ""}\n`);
+    }
+  }
+}
+
+async function cmdDeploymentsGet(config, flags, deploymentId) {
+  if (!deploymentId) throw Object.assign(new Error("deployments get requires a deployment id."), { code: EXIT.USAGE });
+  const data = await apiRequest(config, `/api/deployments/${encodeURIComponent(deploymentId)}`);
+  if (flags.json) printJson(data);
+  else {
+    const d = data.deployment;
+    process.stdout.write(`${d.id}\t${d.siteId}\t${d.status}\t${d.previewUrl || d.deploymentUrl || ""}\n`);
+  }
+}
+
+async function cmdPromote(config, flags, deploymentId) {
+  if (!deploymentId) throw Object.assign(new Error("promote requires a deployment id."), { code: EXIT.USAGE });
+  const data = await apiRequest(config, `/api/deployments/${encodeURIComponent(deploymentId)}/promote`, { method: "POST" });
+  if (flags.json) printJson(data);
+  else process.stdout.write("Promoted to production.\n");
+}
+
+async function cmdRollback(config, flags, deploymentId) {
+  if (!deploymentId) throw Object.assign(new Error("rollback requires a deployment id."), { code: EXIT.USAGE });
+  const data = await apiRequest(config, `/api/deployments/${encodeURIComponent(deploymentId)}/rollback`, { method: "POST" });
+  if (flags.json) printJson(data);
+  else process.stdout.write("Rollback deployment queued.\n");
+}
+
+async function cmdGithubStatus(config, flags) {
+  const data = await apiRequest(config, "/api/github/status");
+  if (flags.json) printJson(data);
+  else process.stdout.write(data.connected ? `GitHub connected (installation ${data.installationId})\n` : "GitHub not connected\n");
+}
+
+async function cmdGithubInstall(config, flags) {
+  const data = await apiRequest(config, "/api/github/install");
+  if (flags.json) printJson(data);
+  else process.stdout.write(`Open this URL in your browser to connect GitHub:\n${data.url}\n`);
+}
+
+async function main() {
+  const argv = process.argv.slice(2);
+  if (!argv.length) {
+    usage();
+    process.exit(EXIT.USAGE);
+  }
+
+  const { flags, positional } = parseFlags(argv);
+  if (flags.help || (positional.length === 1 && positional[0] === "help")) {
+    usage();
+    await finishWithExitCode(EXIT.OK);
+    return;
+  }
+
+  const config = resolveConfig();
+  if (flags.api) config.api = flags.api.replace(/\/$/, "");
+
+  try {
+    const [command, sub, ...rest] = positional;
+    if (command === "login") await cmdLogin(flags);
+    else if (command === "me") await cmdMe(config, flags);
+    else if (command === "env") await cmdEnv(config);
+    else if (command === "deploy") await cmdDeploy(config, flags, sub);
+    else if (command === "sites" && sub === "list") await cmdSitesList(config, flags);
+    else if (command === "projects" && sub === "list") await cmdProjectsList(config, flags);
+    else if (command === "projects" && sub === "get") await cmdProjectsGet(config, flags, rest[0]);
+    else if (command === "projects" && sub === "deploy") await cmdProjectDeploy(config, flags, rest[0]);
+    else if (command === "projects" && sub === "dispatch") await cmdProjectDispatch(config, flags, rest[0]);
+    else if (command === "deployments" && sub === "list") await cmdDeploymentsList(config, flags);
+    else if (command === "deployments" && sub === "get") await cmdDeploymentsGet(config, flags, rest[0]);
+    else if (command === "promote") await cmdPromote(config, flags, sub);
+    else if (command === "rollback") await cmdRollback(config, flags, sub);
+    else if (command === "github" && sub === "status") await cmdGithubStatus(config, flags);
+    else if (command === "github" && sub === "install") await cmdGithubInstall(config, flags);
+    else {
+      usage();
+      process.exitCode = EXIT.USAGE;
+      return;
+    }
+    await finishWithExitCode(EXIT.OK);
+  } catch (error) {
+    const code = error.code ?? (error.status === 401 ? EXIT.AUTH : EXIT.DEPLOY_FAILED);
+    process.stderr.write(`${error.message}\n`);
+    if (flags.json) printJson({ error: error.message, ...(error.body ? { details: error.body } : {}) });
+    await finishWithExitCode(code);
+  }
+}
+
+main().catch(async (error) => {
+  process.stderr.write(`${error.message}\n`);
+  await finishWithExitCode(EXIT.DEPLOY_FAILED);
+});

package/lib/config.js

@@ -0,0 +1,31 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+
+export const CONFIG_PATH = path.join(os.homedir(), ".hypurrcloud");
+
+export function loadConfigFile() {
+  try {
+    const raw = fs.readFileSync(CONFIG_PATH, "utf8");
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+
+export function saveConfigFile(config) {
+  fs.mkdirSync(path.dirname(CONFIG_PATH), { recursive: true });
+  fs.writeFileSync(CONFIG_PATH, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+}
+
+export function resolveConfig() {
+  const file = loadConfigFile();
+  const api = (process.env.HYPURRCLOUD_API || file.api || "").replace(/\/$/, "");
+  const token = process.env.HYPURRCLOUD_TOKEN || file.token || "";
+  return { api, token };
+}
+
+/** Default must match Worker API_PUBLIC_ORIGIN or api.${SITE_BASE_DOMAIN} in wrangler.toml */
+export function defaultApiForHost(siteBase = "hypurrcloud-prod.mdmushtaq.online") {
+  return `https://api.${siteBase}`;
+}

package/lib/http.js

@@ -0,0 +1,62 @@
+export const EXIT = {
+  OK: 0,
+  DEPLOY_FAILED: 1,
+  USAGE: 2,
+  AUTH: 3,
+};
+
+/** Release undici keep-alive sockets so the CLI can exit without racing process.exit on Windows. */
+export async function closeHttpSession() {
+  try {
+    const { getGlobalDispatcher } = await import("node:undici");
+    await getGlobalDispatcher().close();
+  } catch {
+    // node:undici unavailable — natural exit is sufficient
+  }
+}
+
+export async function finishWithExitCode(code) {
+  process.exitCode = code;
+  await closeHttpSession();
+}
+
+export async function apiRequest(config, pathname, options = {}) {
+  if (!config.api) {
+    throw Object.assign(new Error("HYPURRCLOUD_API is not set. Run hypurrcloud login or set HYPURRCLOUD_API."), { code: EXIT.USAGE });
+  }
+  if (!config.token) {
+    throw Object.assign(new Error("HYPURRCLOUD_TOKEN is not set. Run hypurrcloud login or set HYPURRCLOUD_TOKEN."), { code: EXIT.AUTH });
+  }
+
+  const url = `${config.api}${pathname.startsWith("/") ? pathname : `/${pathname}`}`;
+  const headers = {
+    Authorization: `Bearer ${config.token}`,
+    Connection: "close",
+    ...(options.headers || {}),
+  };
+
+  const response = await fetch(url, { ...options, headers, keepalive: false });
+  const text = await response.text();
+  let data;
+  try {
+    data = text ? JSON.parse(text) : {};
+  } catch {
+    data = { error: text || response.statusText };
+  }
+
+  if (response.status === 401) {
+    const err = new Error(data.error === "token_expired" ? "API token expired." : (data.error || "Authentication failed."));
+    err.code = EXIT.AUTH;
+    err.body = data;
+    throw err;
+  }
+
+  if (!response.ok) {
+    const err = new Error(data.error || `Request failed (${response.status}).`);
+    err.status = response.status;
+    err.body = data;
+    throw err;
+  }
+
+  return data;
+}

package/lib/zip.js

@@ -0,0 +1,116 @@
+import fs from "node:fs";
+import path from "node:path";
+import { Buffer } from "node:buffer";
+import { deflateRawSync } from "node:zlib";
+
+const SKIP_DIRS = new Set(["node_modules", ".git"]);
+
+export function shouldSkipEntry(relativePath, includeDotfiles) {
+  const parts = relativePath.split(/[/\\]/);
+  for (const part of parts) {
+    if (!includeDotfiles && part.startsWith(".") && part !== "." && part !== "..") return true;
+    if (SKIP_DIRS.has(part)) return true;
+  }
+  return false;
+}
+
+export function walkDirectory(rootDir, includeDotfiles = false) {
+  const files = [];
+  function walk(current, prefix = "") {
+    for (const name of fs.readdirSync(current)) {
+      const abs = path.join(current, name);
+      const rel = prefix ? `${prefix}/${name}` : name;
+      if (shouldSkipEntry(rel, includeDotfiles)) continue;
+      const stat = fs.statSync(abs);
+      if (stat.isDirectory()) walk(abs, rel);
+      else files.push({ rel: rel.replace(/\\/g, "/"), abs });
+    }
+  }
+  walk(rootDir);
+  return files;
+}
+
+function crc32(buf) {
+  let crc = 0xffffffff;
+  for (let i = 0; i < buf.length; i++) {
+    crc ^= buf[i];
+    for (let j = 0; j < 8; j++) crc = (crc >>> 1) ^ (crc & 1 ? 0xedb88320 : 0);
+  }
+  return (crc ^ 0xffffffff) >>> 0;
+}
+
+function u16(n) {
+  const b = Buffer.alloc(2);
+  b.writeUInt16LE(n, 0);
+  return b;
+}
+
+function u32(n) {
+  const b = Buffer.alloc(4);
+  b.writeUInt32LE(n, 0);
+  return b;
+}
+
+export function buildZipBuffer(fileEntries) {
+  const parts = [];
+  const central = [];
+  let offset = 0;
+
+  for (const { rel, abs } of fileEntries) {
+    const data = fs.readFileSync(abs);
+    const name = Buffer.from(rel, "utf8");
+    const compressed = deflateRawSync(data);
+    const local = Buffer.concat([
+      u32(0x04034b50),
+      u16(20),
+      u16(0),
+      u16(8),
+      u16(0),
+      u16(0),
+      u32(crc32(data)),
+      u32(compressed.length),
+      u32(data.length),
+      u16(name.length),
+      u16(0),
+      name,
+      compressed,
+    ]);
+    parts.push(local);
+    const centralHeader = Buffer.concat([
+      u32(0x02014b50),
+      u16(20),
+      u16(20),
+      u16(0),
+      u16(8),
+      u16(0),
+      u16(0),
+      u32(crc32(data)),
+      u32(compressed.length),
+      u32(data.length),
+      u16(name.length),
+      u16(0),
+      u16(0),
+      u16(0),
+      u16(0),
+      u32(0),
+      u32(offset),
+      name,
+    ]);
+    central.push(centralHeader);
+    offset += local.length;
+  }
+
+  const centralDir = Buffer.concat(central);
+  const end = Buffer.concat([
+    u32(0x06054b50),
+    u16(0),
+    u16(0),
+    u16(fileEntries.length),
+    u16(fileEntries.length),
+    u32(centralDir.length),
+    u32(offset),
+    u16(0),
+  ]);
+
+  return Buffer.concat([...parts, centralDir, end]);
+}

package/package.json

@@ -1,6 +1,24 @@
 {
   "name": "hypurrcloud",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "HypurrCloud command-line interface for deploys and site management",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "hypurrcloud": "bin/hypurrcloud.js"
+  },
+  "files": [
+    "README.md",
+    "bin",
+    "lib"
+  ],
+  "keywords": [
+    "hypurrcloud",
+    "deploy",
+    "static-site",
+    "cli"
+  ]
+}