nylorun 0.4.0-beta → 0.5.0-beta

package/dist/project/link.d.ts

@@ -1,13 +1,13 @@
 /**
  * The Project link (`.nylorun/link.json`) and credentials (`.nylorun/credentials.json`).
- * `nylorun start` writes both, format 2: the stack the Project uses, its URL and Host id, and
- * the Tenant id as information (nothing selects a Tenant). Formats 0 and 1 named a Tenant on a
- * multi-Tenant Host of an older Runtime.
+ * `nylorun start` writes both, format 3: the local Tenant's name, its URL and Host id, and
+ * the Tenant id as information (nothing in a request selects a Tenant). `start` replaces a link
+ * of an older format.
  */
 export interface ProjectLink {
-    format: 0 | 1 | 2;
-    /** The local stack (format 2). */
-    stack?: string;
+    format: 0 | 1 | 2 | 3;
+    /** The local Tenant's name (format 3). */
+    tenant?: string;
     hostUrl: string;
     hostId: string;
     tenantId?: string;
@@ -17,7 +17,7 @@ export declare function credentialsPath(projectRoot: string): string;
 /** The Project's link, or undefined when it has none. An unreadable link is an error. */
 export declare function readProjectLink(projectRoot: string): Promise<ProjectLink | undefined>;
 export declare function writeProjectLink(projectRoot: string, link: {
-    stack: string;
+    tenant: string;
     hostUrl: string;
     hostId: string;
     tenantId: string;

package/dist/project/link.js

@@ -33,7 +33,7 @@ export async function readProjectLink(projectRoot) {
     const link = parsed.data;
     return {
         format: link.format,
-        ...(link.stack ? { stack: link.stack } : {}),
+        ...(link.format === 3 && link.tenant ? { tenant: link.tenant } : {}),
         hostUrl: link.hostUrl.replace(/\/$/, ""),
         hostId: link.hostId,
         ...(link.tenantId ? { tenantId: link.tenantId } : {}),
@@ -60,8 +60,8 @@ async function ensureProjectDir(projectRoot) {
 export async function writeProjectLink(projectRoot, link) {
     await ensureProjectDir(projectRoot);
     await writePrivate(linkPath(projectRoot), {
-        format: 2,
-        stack: link.stack,
+        format: 3,
+        tenant: link.tenant,
         hostUrl: link.hostUrl.replace(/\/$/, ""),
         hostId: link.hostId,
         tenantId: link.tenantId,

package/dist/stack/commands.d.ts

@@ -5,7 +5,7 @@ import { type FetchLike } from "./studio-login.js";
 export declare const STACK_SERVICES: readonly ["postgres", "restate", "s2", "gateway", "runtime", "studio"];
 export declare const stackUsage: string;
 export interface StackDeps {
-    /** Environment snapshot (NYLORUN_HOME, NYLORUN_STACK, image overrides, NYLORUN_STACK_PROJECT). */
+    /** Environment snapshot (NYLORUN_HOME, NYLORUN_TENANT, image overrides, NYLORUN_COMPOSE_PROJECT). */
     env: Readonly<Record<string, string | undefined>>;
     docker: DockerRunner;
     fetch: FetchLike;
@@ -26,7 +26,7 @@ export interface StackDeps {
     pidAlive(pid: number): boolean;
     /** Where the project is looked for (default: the process's working directory). */
     cwd?: string;
-    /** `~/.nylorun`: the stacks and the legacy stack (tests use a temporary directory). */
+    /** `~/.nylorun`: the Tenants (tests use a temporary directory). */
     nylorunRoot?: string;
     /** Delay between health polls; tests shorten it. */
     pollMs?: number;
@@ -35,7 +35,7 @@ export interface StackDeps {
     /** How long a Studio login is retried before warning. */
     loginTimeoutMs?: number;
 }
-/** The Compose project of stack `name`: `nylorun-<name>`, or `NYLORUN_STACK_PROJECT`. */
+/** The Compose project of Tenant `name`: `nylorun-<name>`, or `NYLORUN_COMPOSE_PROJECT`. */
 export declare function stackProject(env: StackDeps["env"], name: string): string;
 interface Flags {
     rest: string[];
@@ -55,7 +55,7 @@ export type StackTenant = Pick<HostTenant, "id" | "name" | "state" | "cause">;
 /** Printed by `start` when it does not open Studio itself. */
 export declare const STUDIO_SIGN_IN_HINT = "To sign a browser in to Studio, run \"npx nylorun studio\".";
 export interface StackStatus {
-    /** The stack's name. */
+    /** The Tenant's name. */
     name: string;
     /** The Compose project. */
     project: string;
@@ -64,13 +64,13 @@ export interface StackStatus {
     state: "running" | "stopped" | "absent";
     runtime: {
         url?: string;
-        /** The Admin API (operator listener), when the stack publishes one. */
+        /** The Admin API (operator listener), when the Tenant publishes one. */
         adminUrl?: string;
         healthy: boolean;
         version?: string;
         hostId?: string;
     };
-    /** The stack's one Tenant, while the Runtime answers. */
+    /** The Tenant as the Runtime reports it, while it answers. */
     tenant?: StackTenant;
     studio: {
         url?: string;
@@ -92,9 +92,9 @@ export interface StackStatus {
 export declare function readStackStatus(deps: StackDeps, options?: {
     name?: string;
 }): Promise<StackStatus>;
-/** The running stack as clients reach it. */
+/** The running Tenant as clients reach it. */
 export interface StackEndpoints {
-    /** The stack's name. */
+    /** The Tenant's name. */
     name: string;
     /** The Host root. */
     home: string;
@@ -111,7 +111,7 @@ export interface StackEndpoints {
     started: boolean;
 }
 /**
- * Start the selected stack unless it is already running (`nylorun studio`): the
+ * Start the selected Tenant unless it is already running (`nylorun studio`): the
  * `start` code path without its output, its Tenant wait or the Project link. Compose
  * progress still streams, since the first run pulls images.
  */
@@ -121,18 +121,18 @@ export declare function ensureStack(deps: StackDeps, options: {
 }): Promise<StackEndpoints>;
 /** Add Studio's `next` path (e.g. `/tenants/<id>`) to a login URL. */
 export declare function withNext(loginUrl: string, next: string | undefined): string;
-/** The Studio page of the stack's Tenant, as a login `next` path. */
+/** The Tenant's Studio page, as a login `next` path. */
 export declare function tenantStudioPath(tenantId: string): string;
 /**
- * Mint a fresh Studio login URL on a running stack, landing on `next`.
+ * Mint a fresh Studio login URL on a running Tenant, landing on `next`.
  * Undefined (after a warning) when Studio does not answer.
  */
-export declare function studioLoginUrl(deps: StackDeps, stack: Pick<StackEndpoints, "studioPort" | "adminKey">, next?: string): Promise<string | undefined>;
-/** `nylorun studio`, landing on `next` when given, else on the stack's Tenant. */
+export declare function studioLoginUrl(deps: StackDeps, running: Pick<StackEndpoints, "studioPort" | "adminKey">, next?: string): Promise<string | undefined>;
+/** `nylorun studio`, landing on `next` when given, else on the Tenant's page. */
 export declare function runStudioCommand(args: readonly string[], deps: StackDeps, options?: {
     next?: string;
 }): Promise<number>;
 export declare function isStackCommand(name: string | undefined): boolean;
-/** Run one stack command (`up`/`start`, `down`/`stop`, `status`, `logs`, `reset`, `studio`, `ls`, `delete`, `legacy`). */
+/** Run one Tenant command (`up`/`start`, `down`/`stop`, `status`, `logs`, `reset`, `studio`, `ls`, `delete`). */
 export declare function runStackCommand(name: string, args: readonly string[], deps: StackDeps): Promise<number>;
 export {};