@lizard-build/cli 0.1.0 → 0.3.29

package/dist/lib/resolve.d.ts

@@ -0,0 +1,85 @@
+import { type ResourceScope } from "./api.js";
+/**
+ * Build a ResourceScope for an arbitrary project. When the project matches the
+ * cwd link, reuse its workspaceId (no extra round-trip). Otherwise fetch the
+ * project's workspace once so cross-project commands (`-p other-project`) still
+ * get `?workspaceId=…` on the request — without it the backend can 404 a
+ * project the user reaches via workspace membership.
+ */
+export declare function scopeForProject(projectId: string): Promise<ResourceScope>;
+/**
+ * Resolve a service (app or addon) within a project. Match by ID or name.
+ * Throws with a helpful list of available services when not found.
+ */
+export declare function resolveService(projectId: string, nameOrId: string): Promise<{
+    id: string;
+    name: string;
+    kind: "app" | "addon";
+}>;
+/**
+ * Pick the active service for a command:
+ *   1. --service flag (resolve by name/id)
+ *   2. linked service in cwd
+ *   3. throw with hint to pass --service
+ */
+export declare function getActiveService(serviceFlag: string | undefined, projectId: string): Promise<{
+    id: string;
+    name: string;
+}>;
+/**
+ * Same as `getActiveService`, but also returns whether the target is an app
+ * or an addon. Costs one extra `/services` lookup when the service is taken
+ * from the cwd link (which otherwise resolves locally), so use this only when
+ * the caller branches on kind (e.g. `lizard scale`).
+ */
+export declare function getActiveServiceWithKind(serviceFlag: string | undefined, projectId: string): Promise<{
+    id: string;
+    name: string;
+    kind: "app" | "addon";
+}>;
+/**
+ * Look up the workspace id for a project. Used to lazy-fill legacy links
+ * that were saved before workspaces existed. Returns null if the project
+ * isn't accessible to the current user.
+ */
+export declare function lookupProjectWorkspace(projectId: string): Promise<{
+    workspaceId?: string | null;
+    workspaceName?: string | null;
+} | null>;
+/**
+ * Resolve a project flag → `{ projectId, scope }`. Scope carries
+ * workspaceId for `withScope(url, scope)` queries.
+ *
+ * For the linked project, lazy-fills missing workspaceId into the cwd link.
+ * For a different project (`-p other-project`), fetches the target's
+ * workspace so the scope reflects the target — not whatever the cwd link
+ * happened to be pointing at.
+ */
+export declare function resolveProjectScope(projectFlag?: string): Promise<{
+    projectId: string;
+    scope: ResourceScope;
+}>;
+export interface ResolvedContext {
+    projectId: string;
+    workspaceId?: string;
+    workspaceName?: string;
+    service?: {
+        id: string;
+        name: string;
+    };
+}
+/** Build the scope object for `withScope(url, scope)` API calls. */
+export declare function getScope(ctx: ResolvedContext): ResourceScope;
+/**
+ * Convenience: resolve project + active service in one go.
+ *
+ * Lazily backfills `workspaceId` into the cwd link when missing (legacy
+ * configs written before workspaces existed). Once filled, subsequent
+ * commands get the scope param for free.
+ */
+export declare function resolveContext(opts: {
+    projectFlag?: string;
+    serviceFlag?: string;
+    workspaceFlag?: string;
+    requireService?: boolean;
+}): Promise<ResolvedContext>;

package/dist/lib/resolve.js

@@ -0,0 +1,203 @@
+import { api, withScope } from "./api.js";
+import { getProjectLink, resolveProjectId, updateProjectLink, } from "./config.js";
+/**
+ * Build a ResourceScope for an arbitrary project. When the project matches the
+ * cwd link, reuse its workspaceId (no extra round-trip). Otherwise fetch the
+ * project's workspace once so cross-project commands (`-p other-project`) still
+ * get `?workspaceId=…` on the request — without it the backend can 404 a
+ * project the user reaches via workspace membership.
+ */
+export async function scopeForProject(projectId) {
+    const link = getProjectLink();
+    if (link?.projectId === projectId && link.workspaceId) {
+        return { workspaceId: link.workspaceId };
+    }
+    const fetched = await lookupProjectWorkspace(projectId);
+    return { workspaceId: fetched?.workspaceId ?? null };
+}
+/**
+ * Resolve a service (app or addon) within a project. Match by ID or name.
+ * Throws with a helpful list of available services when not found.
+ */
+export async function resolveService(projectId, nameOrId) {
+    const data = await api.get(withScope(`/api/projects/${projectId}/services`, await scopeForProject(projectId)));
+    const apps = data.apps || [];
+    const addons = data.addons || [];
+    const lower = nameOrId.toLowerCase();
+    const app = apps.find((a) => a.id.toLowerCase() === lower || a.name?.toLowerCase() === lower);
+    if (app)
+        return { id: app.id, name: app.name, kind: "app" };
+    const addon = addons.find((a) => a.id.toLowerCase() === lower ||
+        a.name?.toLowerCase() === lower ||
+        a.addonType?.toLowerCase() === lower);
+    if (addon) {
+        return { id: addon.id, name: addon.name || addon.addonType || "", kind: "addon" };
+    }
+    const available = [
+        ...apps.map((a) => a.name),
+        ...addons.map((a) => a.name || a.addonType),
+    ].filter(Boolean);
+    throw new Error(`Service "${nameOrId}" not found in project. ` +
+        (available.length ? `Available: ${available.join(", ")}` : "No services exist."));
+}
+/**
+ * Pick the active service for a command:
+ *   1. --service flag (resolve by name/id)
+ *   2. linked service in cwd
+ *   3. throw with hint to pass --service
+ */
+export async function getActiveService(serviceFlag, projectId) {
+    if (serviceFlag) {
+        const resolved = await resolveService(projectId, serviceFlag);
+        return { id: resolved.id, name: resolved.name };
+    }
+    const link = getProjectLink();
+    if (link?.serviceId) {
+        return {
+            id: link.serviceId,
+            name: link.serviceName || link.serviceId,
+        };
+    }
+    throw new Error("No service specified. Pass --service <name> or run `lizard service link <name>`.");
+}
+/**
+ * Same as `getActiveService`, but also returns whether the target is an app
+ * or an addon. Costs one extra `/services` lookup when the service is taken
+ * from the cwd link (which otherwise resolves locally), so use this only when
+ * the caller branches on kind (e.g. `lizard scale`).
+ */
+export async function getActiveServiceWithKind(serviceFlag, projectId) {
+    if (serviceFlag) {
+        return resolveService(projectId, serviceFlag);
+    }
+    const link = getProjectLink();
+    if (link?.serviceId) {
+        const data = await api.get(withScope(`/api/projects/${projectId}/services`, await scopeForProject(projectId)));
+        const app = data.apps?.find((a) => a.id === link.serviceId);
+        if (app)
+            return { id: app.id, name: app.name, kind: "app" };
+        const addon = data.addons?.find((a) => a.id === link.serviceId);
+        if (addon) {
+            return {
+                id: addon.id,
+                name: addon.name || addon.addonType || link.serviceName || link.serviceId,
+                kind: "addon",
+            };
+        }
+        throw new Error(`Linked service "${link.serviceName || link.serviceId}" no longer exists in this project.`);
+    }
+    throw new Error("No service specified. Pass --service <name> or run `lizard service link <name>`.");
+}
+/**
+ * Look up the workspace id for a project. Used to lazy-fill legacy links
+ * that were saved before workspaces existed. Returns null if the project
+ * isn't accessible to the current user.
+ */
+export async function lookupProjectWorkspace(projectId) {
+    try {
+        const proj = await api.get(`/api/projects/${projectId}`);
+        return {
+            workspaceId: proj.workspaceId ?? null,
+            workspaceName: proj.workspaceName ?? null,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve a project flag → `{ projectId, scope }`. Scope carries
+ * workspaceId for `withScope(url, scope)` queries.
+ *
+ * For the linked project, lazy-fills missing workspaceId into the cwd link.
+ * For a different project (`-p other-project`), fetches the target's
+ * workspace so the scope reflects the target — not whatever the cwd link
+ * happened to be pointing at.
+ */
+export async function resolveProjectScope(projectFlag) {
+    const projectId = await resolveProjectId(projectFlag);
+    const link = getProjectLink();
+    // Same project as the cwd link — reuse cached workspaceId, lazy-fill if missing.
+    if (link?.projectId === projectId) {
+        let workspaceId = link.workspaceId ?? null;
+        let workspaceName = link.workspaceName;
+        if (!workspaceId) {
+            const fetched = await lookupProjectWorkspace(projectId);
+            if (fetched?.workspaceId) {
+                workspaceId = fetched.workspaceId;
+                workspaceName = fetched.workspaceName ?? undefined;
+                try {
+                    updateProjectLink({ workspaceId, workspaceName });
+                }
+                catch { }
+            }
+        }
+        return { projectId, scope: { workspaceId: workspaceId ?? null } };
+    }
+    // Different project — never reuse the link's workspaceId. Look up the
+    // target project's workspace directly. Mirrors `scopeForProject`.
+    const scope = await scopeForProject(projectId);
+    return { projectId, scope };
+}
+/** Build the scope object for `withScope(url, scope)` API calls. */
+export function getScope(ctx) {
+    return {
+        workspaceId: ctx.workspaceId ?? null,
+    };
+}
+/**
+ * Convenience: resolve project + active service in one go.
+ *
+ * Lazily backfills `workspaceId` into the cwd link when missing (legacy
+ * configs written before workspaces existed). Once filled, subsequent
+ * commands get the scope param for free.
+ */
+export async function resolveContext(opts) {
+    const projectId = await resolveProjectId(opts.projectFlag);
+    let service;
+    const link = getProjectLink();
+    if (opts.serviceFlag || opts.requireService) {
+        service = await getActiveService(opts.serviceFlag, projectId);
+    }
+    else if (link?.serviceId) {
+        service = {
+            id: link.serviceId,
+            name: link.serviceName || link.serviceId,
+        };
+    }
+    // Workspace resolution: only reuse the link's workspaceId when it
+    // describes the same project. For cross-project commands we fetch the
+    // target project's workspace so the scope is correct — using the link's
+    // ws here would scope into the wrong workspace.
+    let workspaceId;
+    let workspaceName;
+    if (link?.projectId === projectId) {
+        workspaceId = link.workspaceId;
+        workspaceName = link.workspaceName;
+        if (!workspaceId) {
+            const fetched = await lookupProjectWorkspace(projectId);
+            if (fetched?.workspaceId) {
+                workspaceId = fetched.workspaceId;
+                workspaceName = fetched.workspaceName ?? undefined;
+                try {
+                    updateProjectLink({ workspaceId, workspaceName });
+                }
+                catch {
+                    // Non-fatal: link may not exist for this cwd (e.g. --project flag).
+                }
+            }
+        }
+    }
+    else {
+        const fetched = await lookupProjectWorkspace(projectId);
+        workspaceId = fetched?.workspaceId ?? undefined;
+        workspaceName = fetched?.workspaceName ?? undefined;
+    }
+    return {
+        projectId,
+        workspaceId,
+        workspaceName,
+        service,
+    };
+}
+//# sourceMappingURL=resolve.js.map

package/dist/lib/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/lib/resolve.ts"],"names":[],"mappings":"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"}

package/dist/lib/updater.d.ts

@@ -0,0 +1,16 @@
+export declare const CURRENT_VERSION = "0.3.29";
+export type LatestVersionResult = {
+    kind: "ok";
+    version: string;
+} | {
+    kind: "rate-limited";
+    resetAt: number;
+} | {
+    kind: "error";
+};
+export declare function getLatestVersion(): Promise<LatestVersionResult>;
+export declare function selfUpdate(onProgress?: (msg: string) => void): Promise<boolean>;
+/** Check for a newer version and auto-install it in the background.
+ *  Prints a one-line notice on exit — either "Updated to vX.Y.Z" or nothing on failure.
+ *  Never blocks or crashes the current command. */
+export declare function checkForUpdateInBackground(): void;

package/dist/lib/updater.js

@@ -0,0 +1,102 @@
+import { createWriteStream, existsSync, renameSync, chmodSync } from "node:fs";
+import { pipeline } from "node:stream/promises";
+import { Readable } from "node:stream";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+export const CURRENT_VERSION = "0.3.29";
+const RELEASES_API = "https://api.github.com/repos/lizard-build/lizard-cli/releases/latest";
+const RELEASE_BASE = "https://github.com/lizard-build/lizard-cli/releases/latest/download";
+function getBinaryName() {
+    const os = process.platform;
+    const arch = process.arch;
+    if (os === "darwin" && arch === "arm64")
+        return "lizard-darwin-arm64";
+    if (os === "darwin" && arch === "x64")
+        return "lizard-darwin-x64";
+    if (os === "linux" && arch === "x64")
+        return "lizard-linux-x64";
+    if (os === "linux" && arch === "arm64")
+        return "lizard-linux-arm64";
+    return null;
+}
+export async function getLatestVersion() {
+    try {
+        const res = await fetch(RELEASES_API, {
+            headers: { "User-Agent": "lizard-cli" },
+            signal: AbortSignal.timeout(5000),
+        });
+        if (res.status === 403 && res.headers.get("x-ratelimit-remaining") === "0") {
+            const reset = Number(res.headers.get("x-ratelimit-reset"));
+            return { kind: "rate-limited", resetAt: Number.isFinite(reset) ? reset : 0 };
+        }
+        if (!res.ok)
+            return { kind: "error" };
+        const data = (await res.json());
+        const version = data.tag_name?.replace(/^v/, "");
+        return version ? { kind: "ok", version } : { kind: "error" };
+    }
+    catch {
+        return { kind: "error" };
+    }
+}
+export async function selfUpdate(onProgress) {
+    const binaryName = getBinaryName();
+    if (!binaryName)
+        return false;
+    // Find current executable path
+    const currentBin = process.execPath;
+    if (!existsSync(currentBin))
+        return false;
+    const url = `${RELEASE_BASE}/${binaryName}`;
+    const tmp = join(tmpdir(), `lizard-update-${Date.now()}`);
+    onProgress?.(`Downloading ${binaryName}...`);
+    const res = await fetch(url, { signal: AbortSignal.timeout(60000) });
+    if (!res.ok)
+        throw new Error(`Download failed: ${res.status}`);
+    const writer = createWriteStream(tmp);
+    await pipeline(Readable.fromWeb(res.body), writer);
+    chmodSync(tmp, 0o755);
+    onProgress?.("Installing...");
+    renameSync(tmp, currentBin);
+    return true;
+}
+/** Check for a newer version and auto-install it in the background.
+ *  Prints a one-line notice on exit — either "Updated to vX.Y.Z" or nothing on failure.
+ *  Never blocks or crashes the current command. */
+export function checkForUpdateInBackground() {
+    // Only auto-update in TTY; skip CI / piped output
+    if (!process.stdout.isTTY)
+        return;
+    let updateMessage = null;
+    const promise = getLatestVersion().then(async (r) => {
+        if (r.kind !== "ok")
+            return;
+        const latest = r.version;
+        if (latest === CURRENT_VERSION)
+            return;
+        const [maj, min, pat] = latest.split(".").map(Number);
+        const [cmaj, cmin, cpat] = CURRENT_VERSION.split(".").map(Number);
+        const isNewer = maj > cmaj || (maj === cmaj && min > cmin) || (maj === cmaj && min === cmin && pat > cpat);
+        if (!isNewer)
+            return;
+        try {
+            const ok = await selfUpdate();
+            if (ok) {
+                updateMessage =
+                    `\n  Updating lizard v${CURRENT_VERSION} → v${latest}...\n` +
+                        `  lizard updated to v${latest}\n`;
+            }
+        }
+        catch {
+            // silent — don't interrupt the current command
+        }
+    }).catch(() => { });
+    process.on("exit", () => {
+        if (updateMessage)
+            process.stderr.write(updateMessage);
+    });
+    // Don't block process exit
+    if (typeof promise.unref === "function")
+        promise.unref();
+}
+//# sourceMappingURL=updater.js.map

package/dist/lib/updater.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updater.js","sourceRoot":"","sources":["../../src/lib/updater.ts"],"names":[],"mappings":"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"}

package/lizard-wrapper.sh

@@ -0,0 +1,2 @@
+#!/bin/bash
+exec /home/ubuntu/.nvm/versions/node/v22.22.2/bin/node /home/ubuntu/Work/lizard-cli/dist/index.js "$@"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lizard-build/cli",
-  "version": "0.1.0",
+  "version": "0.3.29",
   "description": "Lizard CLI — deploy and manage apps on Lizard",
   "type": "module",
   "bin": {
@@ -9,7 +9,9 @@
   "scripts": {
     "dev": "tsx src/index.ts",
     "build": "tsc",
-    "start": "node dist/index.js"
+    "start": "node dist/index.js",
+    "test": "vitest run test/cli.test.ts",
+    "test:unit": "vitest run test/unit"
   },
   "keywords": [
     "cli",
@@ -17,6 +19,10 @@
     "paas",
     "lizard"
   ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lizard-build/lizard-cli.git"
+  },
   "author": "Lizard Build",
   "license": "MIT",
   "dependencies": {
@@ -29,7 +35,9 @@
   },
   "devDependencies": {
     "@types/node": "^25.6.0",
+    "execa": "^9.6.1",
     "tsx": "^4.21.0",
-    "typescript": "^6.0.3"
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
   }
 }