mfeflow 0.5.0 → 0.7.0

package/dist/commands/team-repo.d.ts

@@ -0,0 +1,9 @@
+import type { Globals } from '../args.js';
+import { type AddResult } from '../output.js';
+import type { Runtime } from '../runtime.js';
+/**
+ * `mfeflow add team-repo <name>`, run in the shell repo: makes `../<name>` a new git repo with the
+ * remote in it, then registers the remote here (a route, staging and prod registry entries and its
+ * dev server in the dev config). The new repo is written first, so a failure here leaves no folder.
+ */
+export declare function addTeamRepo(rt: Runtime, globals: Globals, args: Record<string, unknown>, given: string | undefined): Promise<AddResult>;

package/dist/commands/upgrade.d.ts

@@ -0,0 +1,66 @@
+import { type UpgradeResult } from '../output.js';
+import type { Runtime } from '../runtime.js';
+export declare const UPGRADE_ARGS: {
+    readonly yes: {
+        readonly type: 'boolean';
+        readonly alias: 'y';
+        readonly description: 'Take the defaults and never prompt';
+    };
+    readonly preset: {
+        readonly type: 'string';
+        readonly description: 'Replay options from a JSON file or an https URL';
+        readonly valueHint: 'file|url';
+    };
+    readonly json: {
+        readonly type: 'boolean';
+        readonly description: 'Print one JSON document on stdout, nothing else';
+    };
+    readonly 'dry-run': {
+        readonly type: 'boolean';
+        readonly description: 'Print the summary and diff, write nothing';
+    };
+    readonly cwd: {
+        readonly type: 'string';
+        readonly description: 'Run as if started in this folder';
+        readonly valueHint: 'dir';
+    };
+    readonly install: {
+        readonly type: 'boolean';
+        readonly default: true;
+        readonly description: 'Run the package manager after writing (--no-install to skip)';
+    };
+    readonly verbose: {
+        readonly type: 'boolean';
+        readonly description: 'Show package manager output and stack traces';
+    };
+    readonly local: {
+        readonly type: 'string';
+        readonly description: 'Link @mfeflow/* from a built mfeflow checkout (env MFEFLOW_LOCAL)';
+        readonly valueHint: 'path';
+    };
+    readonly help: {
+        readonly type: 'boolean';
+        readonly alias: 'h';
+        readonly description: 'Show this help';
+    };
+    readonly to: {
+        readonly type: 'string';
+        readonly description: 'The version to upgrade to; only the version of this mfeflow is possible';
+        readonly valueHint: 'version';
+    };
+    readonly accept: {
+        readonly type: 'string';
+        readonly description: 'Replace a file you changed with the new version: a path, a list, or all';
+        readonly valueHint: 'path|all';
+    };
+    readonly keep: {
+        readonly type: 'string';
+        readonly description: 'Keep your version of a file you changed: a path, a list, or all';
+        readonly valueHint: 'path|all';
+    };
+    readonly 'accept-changed-content': {
+        readonly type: 'boolean';
+        readonly description: 'Take registry content that differs from the hash recorded in mfeflow.json: every feature, or only those named after the flag (a,b)';
+    };
+};
+export declare function runUpgrade(rt: Runtime, args: Record<string, unknown>, raw: readonly string[]): Promise<UpgradeResult>;

package/dist/devremotes.d.ts

@@ -0,0 +1,15 @@
+export interface RemoteSpec {
+    name: string;
+    port: number;
+}
+/** The dev server of each remote, relative to the shell app: the one place a polyrepo shell reads them from. */
+export declare const DEV_CONFIG = "apps/shell/public/config/runtime-config.dev.json";
+export declare const DEV_CONFIG_IN_APP = "public/config/runtime-config.dev.json";
+/** `runtime-config.dev.json` of the shell: where each remote's dev server is. */
+export declare function devConfigText(remotes: readonly RemoteSpec[]): string;
+/** The `devRemotes` of a shell's dev config; empty when the file or the key is missing. */
+export declare function readDevRemotes(text: string | undefined): Record<string, string>;
+/** `text` with one more remote in `devRemotes`. */
+export declare function withDevRemote(text: string, remote: RemoteSpec): string;
+/** The port of a dev URL like `http://localhost:4311/mf-manifest.json`. */
+export declare function portOf(url: string): number | undefined;

package/dist/exit.d.ts

@@ -9,6 +9,7 @@ export declare const EXIT: {
     readonly build: 5;
     readonly registry: 6;
     readonly deploy: 7;
+    readonly upgrade: 8;
     readonly cancelled: 130;
 };
 /** Raised when the user backs out of a prompt. */

package/dist/glue.d.ts

@@ -1,11 +1,15 @@
 import { type LoadedFeature, type MfeflowProject } from '@mfeflow/core';
+import type { Globals } from './args.js';
 import type { AssetRoots } from './assets.js';
+import type { Runtime } from './runtime.js';
 export declare const SHELL_PORT = 4300;
 export declare const REMOTE_PORT = 4311;
 export declare function assertAppName(name: string, apps?: MfeflowProject['apps']): void;
 /** The first free port from `start` upwards. */
 export declare function freePort(project: Pick<MfeflowProject, 'apps'>, start: number): number;
 export declare function routeComponent(remote: string): string;
+export declare function portFor(args: Record<string, unknown>, project: Pick<MfeflowProject, 'apps'>, start: number): number;
+export declare function nameFrom(rt: Runtime, globals: Globals, given: string | undefined, what: string): Promise<string>;
 export declare const REGISTRY_ENVS: readonly ['dev', 'staging', 'prod'];
 export interface RemoteSpec {
     name: string;
@@ -18,6 +22,8 @@ export interface GlueOptions {
     remote: RemoteSpec;
     /** Write `registry/envs/<env>/<name>.json`. */
     registry: boolean;
+    /** Which environments get an entry (default all). A polyrepo shell has no dev entry: its dev remotes are in config. */
+    registryEnvs?: readonly string[];
     /** Apps (a shell name, or "shell" for every shell) that get a route to the remote. */
     shells: readonly string[];
 }

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { main } from './cli.js';
 export { COMMANDS } from './cli.js';
 export { EXIT, exitCodeFor } from './exit.js';
 export { validateResult } from './output.js';
-export type { AddResult, BudgetResult, DevResult, DeployResult, CliResult, FailureResult, FeatureInfo, FeaturesResult, InitResult, PlanReport, RegistryEntryInfo, RegistryResult, RegistryStatus, ReportResult, StatusResult, } from './output.js';
+export type { AddResult, AdoptResult, BudgetResult, DevResult, DeployResult, CliResult, FailureResult, FeatureInfo, FeaturesResult, InitResult, PlanReport, RegistryEntryInfo, RegistryResult, RegistryStatus, ReportResult, StatusResult, UpgradeFileReport, UpgradeResult, } from './output.js';
 export { realRuntime, type Runtime } from './runtime.js';
 export type { Io } from './io.js';
 export type { Prompter } from './prompter.js';