mfeflow 0.4.0 → 0.6.0

package/dist/deploy-testing.d.ts

@@ -0,0 +1,41 @@
+import type { RegistryIndexRemote } from '@mfeflow/contracts';
+import { type DeployResult, type FailureResult, type StatusResult } from './output.js';
+import { type TestRuntime } from './testing.js';
+export declare const BASE_URL = "https://cdn.test";
+interface Ran<T> {
+    code: number;
+    result: T;
+    rt: TestRuntime;
+}
+export interface Fixture {
+    root: string;
+    site: string;
+    cleanup(): Promise<void>;
+    /** `mfeflow <argv> --json` against this project and host, for the commands that print a deploy result. */
+    run(...argv: string[]): Promise<Ran<DeployResult>>;
+    /** The same, for a run that must fail with an error document. */
+    fail(...argv: string[]): Promise<Ran<FailureResult>>;
+    /** `mfeflow status <argv> --json`. */
+    status(...argv: string[]): Promise<Ran<StatusResult>>;
+    /** What the host serves for `env`, read straight from disk. */
+    served(env: string, remote?: string): Promise<RegistryIndexRemote | undefined>;
+    hostTree(): Promise<Record<string, string>>;
+    localTree(): Promise<Record<string, string>>;
+}
+/** An object read from JSON text, for tests that poke at it. */
+export declare function parseObject(text: string): Record<string, unknown>;
+export declare function readObject(file: string): Promise<Record<string, unknown>>;
+export declare function failureOf(text: string): FailureResult;
+export declare function statusOf(text: string): StatusResult;
+export declare function deployOf(text: string): DeployResult;
+/** Writes a remote's build: a manifest, an entry and one expose, with content that differs by `marker`. */
+export declare function buildRemote(root: string, name: string, version: string, options?: {
+    marker?: string;
+    entryBytes?: number;
+    reactRange?: string;
+}): Promise<void>;
+export declare function fixture(options?: {
+    env?: Record<string, string>;
+    configure?: boolean;
+}): Promise<Fixture>;
+export {};

package/dist/devregistry.d.ts

@@ -1,10 +1,9 @@
+import type { RegistryIndex, RegistryIndexRemote } from '@mfeflow/contracts';
 import type { ProjectView } from './inspect.js';
-export interface DevRemote {
-    name: string;
-    entry: string;
+export type DevRemote = RegistryIndexRemote & {
     version: string;
-}
-export interface DevIndex {
+};
+export interface DevIndex extends RegistryIndex {
     remotes: DevRemote[];
 }
 /** `name=url` flags as a map. A bare origin means its `/mf-manifest.json`. */

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

@@ -8,7 +8,8 @@ export declare const EXIT: {
     readonly feature: 4;
     readonly build: 5;
     readonly registry: 6;
-    readonly upgrade: 7;
+    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/hosts.d.ts

@@ -0,0 +1,25 @@
+import { type RegistryHost } from '@mfeflow/registry/static';
+export type HostSpec = {
+    kind: 'file';
+    dir: string;
+} | {
+    kind: 's3';
+    bucket: string;
+    prefix: string;
+};
+/** `file:<dir>` or `s3://<bucket>[/prefix]`. A folder is resolved against `cwd`. */
+export declare function parseHostSpec(spec: string, cwd: string): HostSpec;
+/** The host as shown to people and in `--json`: never an endpoint or a credential. */
+export declare function describeHost(host: HostSpec): string;
+type Env = Readonly<Record<string, string | undefined>>;
+/** The secret values the environment holds, so no message can echo them. */
+export declare function secretsOf(env: Env): string[];
+export declare function redact(text: string, secrets: readonly string[]): string;
+export interface OpenOptions {
+    env: Env;
+    /** For tests: stands in for the network. */
+    fetch?: typeof fetch;
+}
+/** Opens the host. S3 settings and credentials come from the environment only. */
+export declare function openHost(spec: HostSpec, options: OpenOptions): Promise<RegistryHost>;
+export {};

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, CliResult, FailureResult, FeatureInfo, FeaturesResult, InitResult, PlanReport, RegistryEntryInfo, RegistryResult, RegistryStatus, ReportResult, } 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';