ninepm 0.68.0 → 0.69.0

package/README.md

@@ -62,6 +62,15 @@ Deploy a static directory:
 9pm deploy . --name my-app --slug my-app
 ```
 
+### How long an app's address stays the same
+
+Check this before printing a link or QR code. The live URL is `<slug>-<suffix>.9pm.ai`, and the suffix comes from the app's internal id, not from the slug:
+
+- Redeploying under the same slug keeps the address.
+- Deleting the app and creating it again under the same slug gives it a **new** address, because the new app gets a new id. Anything printed with the old one stops working.
+- There is no rename: a different address means a different app.
+- A custom domain you own, added on the dashboard's Domains page, gives the app an address of your own. Not every plan includes custom domains.
+
 Deploy a built framework output directory:
 
 ```sh
@@ -137,6 +146,8 @@ Delete an app, its managed database, managed container app, and retained image:
 9pm delete my-app --confirm my-app
 ```
 
+The app's address goes with it: creating an app again under the same slug gives it a new address, so printed links and QR codes stop working. `9pm delete` prints this warning before it deletes anything.
+
 ## Access Modes
 
 Apps are public by default.

package/dist/index.d.ts

@@ -124,7 +124,7 @@ export interface CreatedServiceToken {
     clientSecret: string;
 }
 export type FetchLike = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
-export declare const CLI_VERSION = "0.68.0";
+export declare const CLI_VERSION = "0.69.0";
 type CredentialBackend = "macos-keychain" | "windows-dpapi" | "linux-secret-service" | "file-plaintext" | "none";
 export interface StoredCredentialEntry {
     token: string;
@@ -343,6 +343,7 @@ export interface ListSitesResult {
 export declare function listSites(options: ApiOptions & {
     owner?: string;
 }): Promise<ListSitesResult>;
+export declare function deleteWarningLines(slug: string): string[];
 export declare function deleteSite(options: DeleteSiteOptions): Promise<DeletedSiteResult>;
 export interface DeviceAuthFeedbackOptions {
     progressStream?: NodeJS.WriteStream;
@@ -676,6 +677,17 @@ export declare function parseEnvFileEntries(content: string, kind: "secret" | "v
     value: string;
     kind: "secret" | "var";
 }>;
+export type ListedDeployment = Pick<Deployment, "id" | "version" | "status" | "createdAt"> & {
+    active: boolean;
+};
+export declare function deploymentStatusLabel(deployment: ListedDeployment): string;
+export declare function formatDeploymentsList(deployments: ListedDeployment[]): string[];
+export declare function deploymentsListJson<T extends ListedDeployment>(deployments: T[]): {
+    servingDeploymentId: string | null;
+    deployments: Array<T & {
+        serving: boolean;
+    }>;
+};
 export declare function healthWithReason(status: string | null | undefined, reason: string | null | undefined): string;
 export declare function workerPublicFiles(paths: readonly string[], serverEntry: string, selection: string | null): Array<{
     path: string;

package/dist/index.js

@@ -49,7 +49,7 @@ export function deployDatabaseClause(databases) {
     const listed = databases.map((database) => (database.name ? `${database.bindingName}:${database.name}` : database.bindingName)).join(", ");
     return `${databases.length === 1 ? "database" : "databases"} ${listed}`;
 }
-export const CLI_VERSION = "0.68.0";
+export const CLI_VERSION = "0.69.0";
 const PUBLIC_DASHBOARD_URL = "https://9pm.ai/dashboard";
 const TOKEN_SERVICE = "9pm";
 const TOKEN_ACCOUNT = "default";
@@ -1380,6 +1380,16 @@ export async function listSites(options) {
     const payload = await apiRequest(options, route, { method: "GET" });
     return { projects: payload.projects };
 }
+// Printed before the delete request, never as a prompt: agents run this non-interactively
+// and `--confirm` is already the consent. The address part is the one nobody expects:
+// the hostname's suffix comes from the project id (appHostnameForProject), a new app gets
+// a new random id, and no route renames a project, so the same slug never gets it back.
+export function deleteWarningLines(slug) {
+    return [
+        `Warning: deleting ${slug} also gives up its address for good. An app created again under the same slug gets a new address, so links, bookmarks and printed QR codes pointing at the current one will stop working.`,
+        "Its deployments, files and managed database (if it has one) are deleted with it and cannot be recovered.",
+    ];
+}
 export async function deleteSite(options) {
     const route = `/v1/sites/${encodeURIComponent(options.site)}${options.owner ? `?owner=${encodeURIComponent(options.owner)}` : ""}`;
     const payload = await apiRequest(options, route, {
@@ -3116,21 +3126,45 @@ function parseDeploymentsArgs(argv) {
     }
     throw new Error(`Unknown deployments subcommand: ${subcommand}`);
 }
+export function deploymentStatusLabel(deployment) {
+    if (deployment.active) {
+        return "serving";
+    }
+    return deployment.status === "active" ? "active, not serving" : deployment.status;
+}
+export function formatDeploymentsList(deployments) {
+    if (deployments.length === 0) {
+        return ["No deployments."];
+    }
+    const header = ["ID", "VERSION", "STATUS", "CREATED"];
+    const rows = deployments.map((deployment) => [deployment.id, `v${deployment.version}`, deploymentStatusLabel(deployment), deployment.createdAt]);
+    const widths = header.map((title, column) => Math.max(title.length, ...rows.map((row) => (row[column] ?? "").length)));
+    const render = (cells) => cells.map((cell, column) => (column === cells.length - 1 ? cell : cell.padEnd(widths[column] ?? 0))).join("  ");
+    const lines = [render(header), ...rows.map(render), ""];
+    const serving = deployments.find((deployment) => deployment.active);
+    lines.push(serving ? `Serving: v${serving.version} (${serving.id}).` : "No deployment is serving this app.");
+    if (deployments.some((deployment) => !deployment.active && deployment.status === "active")) {
+        lines.push('Rows marked "active, not serving" are earlier deploys that finished; they no longer receive traffic.');
+    }
+    return lines;
+}
+export function deploymentsListJson(deployments) {
+    return {
+        servingDeploymentId: deployments.find((deployment) => deployment.active)?.id ?? null,
+        deployments: deployments.map((deployment) => ({ ...deployment, serving: deployment.active })),
+    };
+}
 async function runDeploymentsCommand(command) {
     const base = { apiUrl: command.apiUrl, token: command.token };
     const action = command.action;
     if (action.kind === "ls") {
         const result = await apiRequest(base, `/v1/sites/${encodeURIComponent(action.site)}/deployments`, { method: "GET" });
         if (action.json) {
-            console.log(JSON.stringify(result, null, 2));
+            console.log(JSON.stringify({ ...result, ...deploymentsListJson(result.deployments) }, null, 2));
             return;
         }
-        if (result.deployments.length === 0) {
-            console.log("No deployments.");
-            return;
-        }
-        for (const deployment of result.deployments) {
-            console.log(`${deployment.active ? "*" : " "} ${deployment.id}\tv${deployment.version}\t${deployment.status}\t${deployment.createdAt}`);
+        for (const line of formatDeploymentsList(result.deployments)) {
+            console.log(line);
         }
         return;
     }
@@ -4700,6 +4734,9 @@ async function main() {
             return;
         }
         if (command.kind === "delete") {
+            for (const line of deleteWarningLines(command.confirmSlug)) {
+                console.warn(line);
+            }
             const deleted = await deleteSite({
                 apiUrl: command.apiUrl,
                 token: command.token,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ninepm",
-  "version": "0.68.0",
+  "version": "0.69.0",
   "description": "CLI for deploying built apps to 9pm.ai.",
   "homepage": "https://9pm.ai",
   "keywords": [