@ethlete/cli 2.0.1-next.2 → 2.1.0-next.4

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @ethlete/cli
 
+## 2.1.0-next.4
+
+### Minor Changes
+
+- [`b6fe4be`](https://github.com/ethlete-io/ethdk/commit/b6fe4beae010aaa2e0e367d636f6759442983395) Thanks [@TomTomB](https://github.com/TomTomB)! - Add `et api` to run an app's backend from a local checkout, declared in `ethlete.apis.js`. The new
+  `ethlete.config.local.json` says where the sibling checkouts on this machine live.
+
+## 2.1.0-next.3
+
+### Minor Changes
+
+- [`edea44b`](https://github.com/ethlete-io/ethdk/commit/edea44bf1c494420f02b545202f4b24db9a6395c) Thanks [@TomTomB](https://github.com/TomTomB)! - Update to angular 22
+
 ## 2.0.1-next.2
 
 ### Patch Changes

package/README.md

@@ -1,11 +1,87 @@
-# cli
+# @ethlete/cli
 
-This library was generated with [Nx](https://nx.dev).
+Repo tooling - installs the `et` binary.
 
-## Building
+## Installation
 
-Run `nx build cli` to build the library.
+```bash
+yarn add --dev @ethlete/cli
+```
 
-## Running unit tests
+## `et release`
 
-Run `nx test cli` to execute the unit tests via [Jest](https://jestjs.io).
+```bash
+yarn et release
+```
+
+Turns pending changesets into a tagged, pushed release commit (version → tag → commit → push).
+
+## `et api`
+
+Runs the API an app in this repo talks to, from a checkout on your own machine.
+
+```bash
+yarn et api up hub          # start the containers
+yarn et api down hub        # stop them
+yarn et api logs hub        # follow the API's log
+yarn et api shell hub       # a shell in the API container
+yarn et api install hub     # an entry from that API's own "exec" map
+yarn et api up hub --host   # also print the address other devices can reach
+```
+
+The first container tool that answers is used, in this order: `docker compose`,
+`container compose`, `podman-compose`, `podman compose`.
+
+### Declaring the APIs
+
+`ethlete.apis.js` at the repo root describes each API's compose setup. It is a module rather
+than JSON because `env` is a function:
+
+```js
+const { sshKeyPath } = require('@ethlete/cli');
+
+module.exports = {
+  hub: {
+    composeDir: 'development',
+    services: ['app', 'database', 'mailhog'],
+    execService: 'app',
+    port: 8040,
+    envFile: '.env',
+    setupCommand: 'make setup',
+    network: 'shared-fut',
+    envKey: 'hubApiEnv',
+    examplePath: '../fut-hub-backend',
+    env: () => ({ SSH_PRIVATE_KEY: sshKeyPath() }),
+    exec: {
+      install: ['composer', 'install'],
+      'reset-db': ['make', 'reset-db-with-dev-fixtures'],
+    },
+  },
+};
+```
+
+Adding an API is an entry in this map. Nothing else changes.
+
+### Where the checkouts live
+
+The paths differ per machine, so they live in a gitignored `ethlete.config.local.json` at the
+repo root. `@ethlete/agent-rules` reads the same file, so its skills and `et` agree on where a
+checkout is:
+
+```json
+{
+  "sdkSourcePath": "/absolute/path/to/ethlete-sdk",
+  "apiRepoPaths": { "hub": "../fut-hub-backend", "*": "../shared-backend" },
+  "apiRepoBranches": { "hub": "develop", "*": "main" }
+}
+```
+
+Matching is exact; `"*"` is an explicit shared fallback. A relative path resolves from the repo
+root. These keys used to live in `ethlete-agents.config.local.json`, which is still read as a
+fallback with a warning. Add `ethlete.config.local.json` to your `.gitignore`.
+
+## Documentation
+
+Full command reference on the docs site:
+
+- [Overview & usage](https://ethlete-sdk-docs.web.app/cli/)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ethlete/cli",
-  "version": "2.0.1-next.2",
+  "version": "2.1.0-next.4",
   "license": "MIT",
   "type": "commonjs",
   "main": "./src/index.js",

package/src/index.d.ts

@@ -1 +1 @@
-export {};
+export * from './lib';

package/src/index.js

@@ -2,19 +2,36 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 const lib_1 = require("./lib");
+const USAGE = `et — Ethlete repo tooling
+
+  et release            Turn pending changesets into a tagged, pushed release commit
+  et api <cmd> <api>    Run an API from this repo's ethlete.apis.js locally
+                        (up, down, logs, shell, plus that API's own exec entries)
+`;
 const cli = (args) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
-    const cliFunctionArg = args[0];
-    switch (cliFunctionArg) {
+    switch (args[0]) {
         case 'release':
-            yield (0, lib_1.release)(args);
-            break;
+            // `release` reads its flags from a list that was split on "=" before this switch existed.
+            // Keep that shape here so its own parsing is untouched.
+            yield (0, lib_1.release)(args.join('=').split('='));
+            return 0;
+        case 'api':
+            return (0, lib_1.apiCommand)({ root: process.cwd(), argv: args.slice(1) });
         default:
-            console.log(`No command found named ${cliFunctionArg}. Available commands are: release`);
-            break;
+            console.log(USAGE);
+            return args[0] === undefined || args[0] === '--help' || args[0] === '-h' ? 0 : 1;
     }
 });
-// Get the command line arguments and normalize them
-const args = process.argv.slice(2).join('=').split('=');
-cli(args);
-// Burst cache
+tslib_1.__exportStar(require("./lib"), exports);
+// Guarded so the package can also be imported as a library without running the CLI.
+if (require.main === module) {
+    cli(process.argv.slice(2))
+        .then((code) => {
+        process.exitCode = code;
+    })
+        .catch((error) => {
+        console.error(error instanceof Error ? error.message : error);
+        process.exitCode = 1;
+    });
+}
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/cli/src/index.ts"],"names":[],"mappings":";;;AAAA,+BAAgC;AAEhC,MAAM,GAAG,GAAG,CAAO,IAAc,EAAE,EAAE;IACnC,MAAM,cAAc,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAE/B,QAAQ,cAAc,EAAE,CAAC;QACvB,KAAK,SAAS;YACZ,MAAM,IAAA,aAAO,EAAC,IAAI,CAAC,CAAC;YACpB,MAAM;QAER;YACE,OAAO,CAAC,GAAG,CAAC,0BAA0B,cAAc,mCAAmC,CAAC,CAAC;YACzF,MAAM;IACV,CAAC;AACH,CAAC,CAAA,CAAC;AAEF,oDAAoD;AACpD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAExD,GAAG,CAAC,IAAI,CAAC,CAAC;AAEV,cAAc"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/cli/src/index.ts"],"names":[],"mappings":";;;AAAA,+BAA4C;AAE5C,MAAM,KAAK,GAAG;;;;;CAKb,CAAC;AAEF,MAAM,GAAG,GAAG,CAAO,IAAc,EAAmB,EAAE;IACpD,QAAQ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAChB,KAAK,SAAS;YACZ,0FAA0F;YAC1F,wDAAwD;YACxD,MAAM,IAAA,aAAO,EAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;YAEzC,OAAO,CAAC,CAAC;QAEX,KAAK,KAAK;YACR,OAAO,IAAA,gBAAU,EAAC,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAElE;YACE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAEnB,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrF,CAAC;AACH,CAAC,CAAA,CAAC;AAEF,gDAAsB;AAEtB,oFAAoF;AACpF,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SACvB,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QACb,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC1B,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QACxB,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC9D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/src/lib/api/api-command.d.ts

@@ -0,0 +1,4 @@
+export declare const apiCommand: ({ root, argv }: {
+    root: string;
+    argv: string[];
+}) => number;

package/src/lib/api/api-command.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiCommand = void 0;
+const load_definitions_1 = require("./load-definitions");
+const run_1 = require("./run");
+const apiCommand = ({ root, argv }) => {
+    const { found, apis } = (0, load_definitions_1.loadApiDefinitions)(root);
+    if (!found) {
+        console.error(`No API definitions found. Create ${load_definitions_1.API_DEFINITIONS_FILE_NAMES[0]} in the repo root:\n\n` +
+            `  const { sshKeyPath } = require('@ethlete/cli');\n\n` +
+            `  module.exports = {\n` +
+            `    hub: {\n` +
+            `      composeDir: 'development',\n` +
+            `      services: ['app', 'database'],\n` +
+            `      execService: 'app',\n` +
+            `      port: 8040,\n` +
+            `      envFile: '.env',\n` +
+            `      setupCommand: 'make setup',\n` +
+            `      exec: { install: ['composer', 'install'] },\n` +
+            `    },\n` +
+            `  };`);
+        return 1;
+    }
+    return (0, run_1.runApiCommand)({ apis, argv, root });
+};
+exports.apiCommand = apiCommand;
+//# sourceMappingURL=api-command.js.map

package/src/lib/api/api-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-command.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/api/api-command.ts"],"names":[],"mappings":";;;AAAA,yDAAoF;AACpF,+BAAsC;AAE/B,MAAM,UAAU,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,EAAoC,EAAE,EAAE;IAC7E,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAA,qCAAkB,EAAC,IAAI,CAAC,CAAC;IAEjD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CACX,oCAAoC,6CAA0B,CAAC,CAAC,CAAC,wBAAwB;YACvF,uDAAuD;YACvD,wBAAwB;YACxB,cAAc;YACd,oCAAoC;YACpC,wCAAwC;YACxC,6BAA6B;YAC7B,qBAAqB;YACrB,0BAA0B;YAC1B,qCAAqC;YACrC,qDAAqD;YACrD,UAAU;YACV,MAAM,CACT,CAAC;QAEF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,IAAA,mBAAa,EAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;AAC7C,CAAC,CAAC;AAxBW,QAAA,UAAU,cAwBrB"}

package/src/lib/api/compose.d.ts

@@ -0,0 +1,17 @@
+export type ComposeTool = {
+    engine: string;
+    /** The binary and its fixed arguments. Non-empty, so the first entry is always the binary. */
+    compose: [string, ...string[]];
+};
+export declare const composeBinary: (compose: string[]) => string[];
+/** Finds the first container tool on this machine that answers `<compose> version`. */
+export declare const resolveComposeTool: (tools?: ComposeTool[]) => ComposeTool | undefined;
+export declare const composeToolNames: (tools?: ComposeTool[]) => string[];
+export declare const engineEnv: (engine: string) => {
+    CONTAINERS_REGISTRIES_CONF: string;
+} | {
+    CONTAINERS_REGISTRIES_CONF?: undefined;
+};
+export declare const lanAddress: () => string | undefined;
+/** Path of this machine's SSH key, for a compose file that mounts one into the API container. */
+export declare const sshKeyPath: () => string | undefined;

package/src/lib/api/compose.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sshKeyPath = exports.lanAddress = exports.engineEnv = exports.composeToolNames = exports.resolveComposeTool = exports.composeBinary = void 0;
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
+/**
+ * SELinux denies a container read access to a bind mount that carries the host's own label, and API
+ * repos mount their checkout without the `:z` that would relabel it. Disabling the label from here
+ * keeps those checkouts untouched.
+ */
+const PODMAN_COMPOSE_ARGS = ['--podman-run-args=--security-opt label=disable'];
+const COMPOSE_TOOLS = [
+    { engine: 'docker', compose: ['docker', 'compose'] },
+    { engine: 'container', compose: ['container', 'compose'] },
+    { engine: 'podman', compose: ['podman-compose', ...PODMAN_COMPOSE_ARGS] },
+    { engine: 'podman', compose: ['podman', 'compose', ...PODMAN_COMPOSE_ARGS] },
+];
+/**
+ * Podman refuses to resolve a short image name such as `mysql:8.0` without a TTY prompt when several
+ * unqualified search registries are configured. API compose files use short names, so point podman
+ * at one registry and turn the prompt off.
+ */
+const PODMAN_REGISTRIES_CONF = `unqualified-search-registries = ["docker.io"]\nshort-name-mode = "disabled"\n`;
+let podmanRegistriesConfPath;
+const writePodmanRegistriesConf = () => {
+    podmanRegistriesConfPath !== null && podmanRegistriesConfPath !== void 0 ? podmanRegistriesConfPath : (podmanRegistriesConfPath = (0, path_1.join)((0, fs_1.mkdtempSync)((0, path_1.join)((0, os_1.tmpdir)(), 'ethlete-api-')), 'registries.conf'));
+    (0, fs_1.writeFileSync)(podmanRegistriesConfPath, PODMAN_REGISTRIES_CONF, 'utf8');
+    return podmanRegistriesConfPath;
+};
+const composeBinary = (compose) => compose.filter((part) => !part.startsWith('--'));
+exports.composeBinary = composeBinary;
+const canRun = (command, args) => {
+    const result = (0, child_process_1.spawnSync)(command, args, { stdio: 'ignore' });
+    return result.error === undefined && result.status === 0;
+};
+/** Finds the first container tool on this machine that answers `<compose> version`. */
+const resolveComposeTool = (tools = COMPOSE_TOOLS) => tools.find(({ compose }) => {
+    const [binary, ...rest] = (0, exports.composeBinary)(compose);
+    return binary !== undefined && canRun(binary, [...rest, 'version']);
+});
+exports.resolveComposeTool = resolveComposeTool;
+const composeToolNames = (tools = COMPOSE_TOOLS) => tools.map(({ compose }) => (0, exports.composeBinary)(compose).join(' '));
+exports.composeToolNames = composeToolNames;
+const engineEnv = (engine) => engine === 'podman' ? { CONTAINERS_REGISTRIES_CONF: writePodmanRegistriesConf() } : {};
+exports.engineEnv = engineEnv;
+const lanAddress = () => {
+    var _a;
+    return (_a = Object.values((0, os_1.networkInterfaces)())
+        .flat()
+        .find((networkInterface) => (networkInterface === null || networkInterface === void 0 ? void 0 : networkInterface.family) === 'IPv4' && !networkInterface.internal)) === null || _a === void 0 ? void 0 : _a.address;
+};
+exports.lanAddress = lanAddress;
+/** Path of this machine's SSH key, for a compose file that mounts one into the API container. */
+const sshKeyPath = () => [(0, path_1.join)((0, os_1.homedir)(), '.ssh/id_ed25519'), (0, path_1.join)((0, os_1.homedir)(), '.ssh/id_rsa')].find((path) => (0, fs_1.existsSync)(path));
+exports.sshKeyPath = sshKeyPath;
+//# sourceMappingURL=compose.js.map

package/src/lib/api/compose.js.map

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

package/src/lib/api/definition.d.ts

@@ -0,0 +1,28 @@
+/** One API this repo can run locally. Everything here describes the API's own compose setup. */
+export type ApiDefinition = {
+    /** Directory inside the API checkout that holds the compose file, for example `development`. */
+    composeDir: string;
+    /** Compose services to start. Leave out a service the app does not need, such as a bundled frontend. */
+    services: string[];
+    /** Service that `shell`, `logs` and every `exec` entry run in. */
+    execService: string;
+    /** Published host port, not the port inside the container. Used for the printed url. */
+    port: number;
+    /** File that must exist in `composeDir` before the API can start, for example `.env`. */
+    envFile?: string;
+    /** Command that creates `envFile`. Named in the error when the file is missing. */
+    setupCommand?: string;
+    /** External container network to create before the first `up`. */
+    network?: string;
+    /** Example path shown in the error that asks the developer to configure this API's checkout. */
+    examplePath?: string;
+    /** localStorage key the app reads to pick its API. Printed by `--host`. */
+    envKey?: string;
+    /** Extra environment for every compose call. An undefined value is dropped rather than passed as "undefined". */
+    env?: () => Record<string, string | undefined>;
+    /** Named commands run in `execService`, for example `{ install: ['composer', 'install'] }`. */
+    exec?: Record<string, string[]>;
+};
+export type ApiDefinitions = Record<string, ApiDefinition>;
+export declare const BUILT_IN_API_COMMANDS: readonly ["up", "down", "logs", "shell"];
+export declare const apiCommandNames: (api: ApiDefinition) => string[];

package/src/lib/api/definition.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiCommandNames = exports.BUILT_IN_API_COMMANDS = void 0;
+exports.BUILT_IN_API_COMMANDS = ['up', 'down', 'logs', 'shell'];
+const apiCommandNames = (api) => { var _a; return [...exports.BUILT_IN_API_COMMANDS, ...Object.keys((_a = api.exec) !== null && _a !== void 0 ? _a : {})]; };
+exports.apiCommandNames = apiCommandNames;
+//# sourceMappingURL=definition.js.map

package/src/lib/api/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/api/definition.ts"],"names":[],"mappings":";;;AA4Ba,QAAA,qBAAqB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAEvE,MAAM,eAAe,GAAG,CAAC,GAAkB,EAAE,EAAE,WAAC,OAAA,CAAC,GAAG,6BAAqB,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,MAAA,GAAG,CAAC,IAAI,mCAAI,EAAE,CAAC,CAAC,CAAA,EAAA,CAAC;AAArG,QAAA,eAAe,mBAAsF"}

package/src/lib/api/index.d.ts

@@ -0,0 +1,5 @@
+export * from './api-command';
+export * from './compose';
+export * from './definition';
+export * from './load-definitions';
+export * from './run';

package/src/lib/api/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./api-command"), exports);
+tslib_1.__exportStar(require("./compose"), exports);
+tslib_1.__exportStar(require("./definition"), exports);
+tslib_1.__exportStar(require("./load-definitions"), exports);
+tslib_1.__exportStar(require("./run"), exports);
+//# sourceMappingURL=index.js.map

package/src/lib/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/api/index.ts"],"names":[],"mappings":";;;AAAA,wDAA8B;AAC9B,oDAA0B;AAC1B,uDAA6B;AAC7B,6DAAmC;AACnC,gDAAsB"}

package/src/lib/api/load-definitions.d.ts

@@ -0,0 +1,16 @@
+import { ApiDefinitions } from './definition';
+export declare const API_DEFINITIONS_FILE_NAMES: string[];
+export type LoadApiDefinitionsResult = {
+    found: true;
+    apis: ApiDefinitions;
+    fileName: string;
+} | {
+    found: false;
+    apis?: undefined;
+    fileName?: undefined;
+};
+/**
+ * Loads the repo's API definitions from `ethlete.apis.js`. The file is a module rather than JSON
+ * because a definition's `env` is a function, which JSON cannot hold.
+ */
+export declare const loadApiDefinitions: (root: string) => LoadApiDefinitionsResult;

package/src/lib/api/load-definitions.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadApiDefinitions = exports.API_DEFINITIONS_FILE_NAMES = void 0;
+const fs_1 = require("fs");
+const module_1 = require("module");
+const path_1 = require("path");
+exports.API_DEFINITIONS_FILE_NAMES = ['ethlete.apis.js', 'ethlete.apis.cjs'];
+/**
+ * Loads the repo's API definitions from `ethlete.apis.js`. The file is a module rather than JSON
+ * because a definition's `env` is a function, which JSON cannot hold.
+ */
+const loadApiDefinitions = (root) => {
+    var _a;
+    const fileName = exports.API_DEFINITIONS_FILE_NAMES.find((candidate) => (0, fs_1.existsSync)((0, path_1.join)(root, candidate)));
+    if (!fileName)
+        return { found: false };
+    const loaded = (0, module_1.createRequire)((0, path_1.join)(root, 'package.json'))((0, path_1.join)(root, fileName));
+    const apis = (_a = loaded.default) !== null && _a !== void 0 ? _a : loaded;
+    return { found: true, apis, fileName };
+};
+exports.loadApiDefinitions = loadApiDefinitions;
+//# sourceMappingURL=load-definitions.js.map

package/src/lib/api/load-definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-definitions.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/api/load-definitions.ts"],"names":[],"mappings":";;;AAAA,2BAAgC;AAChC,mCAAuC;AACvC,+BAA4B;AAGf,QAAA,0BAA0B,GAAG,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,CAAC;AAKlF;;;GAGG;AACI,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAA4B,EAAE;;IAC3E,MAAM,QAAQ,GAAG,kCAA0B,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAEnG,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAEvC,MAAM,MAAM,GAAY,IAAA,sBAAa,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,IAAA,WAAI,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IACxF,MAAM,IAAI,GAAG,MAAC,MAAuC,CAAC,OAAO,mCAAK,MAAyB,CAAC;IAE5F,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AACzC,CAAC,CAAC;AATW,QAAA,kBAAkB,sBAS7B"}

package/src/lib/api/run.d.ts

@@ -0,0 +1,10 @@
+import { ApiDefinitions } from './definition';
+export type RunApiCommandOptions = {
+    apis: ApiDefinitions;
+    /** Arguments after the command name, for example `['up', 'hub', '--host']`. */
+    argv: string[];
+    root?: string;
+    /** How the caller is invoked, used in the usage line. */
+    invocation?: string;
+};
+export declare const runApiCommand: ({ apis, argv, root, invocation }: RunApiCommandOptions) => number;

package/src/lib/api/run.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runApiCommand = void 0;
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const local_config_1 = require("../config/local-config");
+const compose_1 = require("./compose");
+const definition_1 = require("./definition");
+const configHelp = ({ name, api, reason }) => {
+    var _a;
+    return `${reason}\n\nAdd the path of your ${name} API checkout to ${local_config_1.LOCAL_CONFIG_FILE_NAME} in the repo ` +
+        `root. The file is gitignored, so it changes nothing for anyone else:\n\n` +
+        `  {\n    "apiRepoPaths": {\n      "${name}": "${(_a = api.examplePath) !== null && _a !== void 0 ? _a : `../${name}-api`}"\n    }\n  }`;
+};
+const definedEntries = (record) => Object.fromEntries(Object.entries(record).filter(([, value]) => value !== undefined));
+const isDirectory = (path) => (0, fs_1.existsSync)(path) && (0, fs_1.statSync)(path).isDirectory();
+const runApiCommand = ({ apis, argv, root = process.cwd(), invocation = 'et api' }) => {
+    var _a, _b, _c, _d;
+    const exposeOnLan = argv.includes('--host');
+    const [command, name] = argv.filter((arg) => !arg.startsWith('--'));
+    const api = name === undefined ? undefined : apis[name];
+    if (command === undefined || name === undefined || !api) {
+        console.error(`Usage: ${invocation} <command> <api> [--host]\n\nAPIs: ${Object.keys(apis).join(', ')}`);
+        return 1;
+    }
+    const commands = (0, definition_1.apiCommandNames)(api);
+    if (!commands.includes(command)) {
+        console.error(`Unknown command "${command}" for the ${name} API.\n\nCommands: ${commands.join(', ')}`);
+        return 1;
+    }
+    const { config, fileName, isLegacy } = (0, local_config_1.readLocalConfig)(root);
+    const configured = (0, local_config_1.configuredApiRepoPath)(config, name);
+    if (!configured) {
+        console.error(configHelp({
+            name,
+            api,
+            reason: fileName
+                ? `${fileName} has no apiRepoPaths entry for "${name}".`
+                : `${local_config_1.LOCAL_CONFIG_FILE_NAME} does not exist.`,
+        }));
+        return 1;
+    }
+    if (isLegacy) {
+        console.warn(`${local_config_1.LEGACY_LOCAL_CONFIG_FILE_NAME} still holds "apiRepoPaths". Move it to ${local_config_1.LOCAL_CONFIG_FILE_NAME}.\n`);
+    }
+    const repoPath = (0, local_config_1.resolveConfiguredPath)(root, configured);
+    if (!isDirectory(repoPath)) {
+        console.error(`apiRepoPaths.${name} points at ${repoPath}, which is not a directory that exists.`);
+        return 1;
+    }
+    const cwd = (0, path_1.join)(repoPath, api.composeDir);
+    if (!isDirectory(cwd)) {
+        console.error(`${repoPath} has no ${api.composeDir} directory. Is apiRepoPaths.${name} the right checkout?`);
+        return 1;
+    }
+    if (api.envFile && !(0, fs_1.existsSync)((0, path_1.join)(cwd, api.envFile))) {
+        console.error(`Missing ${api.envFile} in ${cwd}.${api.setupCommand ? ` Run "${api.setupCommand}" there first.` : ''}`);
+        return 1;
+    }
+    const tool = (0, compose_1.resolveComposeTool)();
+    if (!tool) {
+        console.error(`No compose tool found. Tried: ${(0, compose_1.composeToolNames)().join(', ')}.`);
+        return 1;
+    }
+    const { engine, compose } = tool;
+    const [binary, ...composePrefix] = compose;
+    const env = Object.assign(Object.assign(Object.assign({}, (0, compose_1.engineEnv)(engine)), process.env), definedEntries((_b = (_a = api.env) === null || _a === void 0 ? void 0 : _a.call(api)) !== null && _b !== void 0 ? _b : {}));
+    let exitCode = 0;
+    const runCompose = (...composeArgs) => {
+        var _a;
+        const result = (0, child_process_1.spawnSync)(binary, [...composePrefix, ...composeArgs], { cwd, env, stdio: 'inherit' });
+        if (result.error) {
+            console.error(result.error.message);
+            exitCode = 1;
+            return;
+        }
+        exitCode = (_a = result.status) !== null && _a !== void 0 ? _a : 1;
+    };
+    if (command === 'up') {
+        if (api.network) {
+            (0, child_process_1.spawnSync)(engine, ['network', 'create', api.network], { stdio: 'ignore' });
+        }
+        runCompose('up', '-d', ...api.services);
+        // podman-compose exits 0 even when it fails to build or pull an image, so the state has to be
+        // read back rather than inferred from the exit code.
+        console.log(`\n${name} API at http://localhost:${api.port}. State:\n`);
+        runCompose('ps');
+        if (exposeOnLan) {
+            const address = (0, compose_1.lanAddress)();
+            if (!address) {
+                console.error('\nThis machine has no external IPv4 address, so the API cannot be reached over the network.');
+                return 1;
+            }
+            const envKeyStep = api.envKey
+                ? `\n  2. Run localStorage.setItem('${api.envKey}', 'http://${address}:${api.port}') on that device.`
+                : '';
+            console.log(`\nThe published ports already listen on every interface, so the API also answers on\n` +
+                `http://${address}:${api.port}. Two more steps make another device use it:\n\n` +
+                `  1. Serve the app with a host binding of 0.0.0.0.${envKeyStep}\n\n` +
+                `A host firewall can still block port ${api.port}.`);
+        }
+    }
+    else if (command === 'down') {
+        runCompose('down');
+    }
+    else if (command === 'logs') {
+        runCompose('logs', '-f', api.execService);
+    }
+    else if (command === 'shell') {
+        runCompose('exec', api.execService, 'bash');
+    }
+    else {
+        runCompose('exec', api.execService, ...((_d = (_c = api.exec) === null || _c === void 0 ? void 0 : _c[command]) !== null && _d !== void 0 ? _d : []));
+    }
+    return exitCode;
+};
+exports.runApiCommand = runApiCommand;
+//# sourceMappingURL=run.js.map

package/src/lib/api/run.js.map

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

package/src/lib/config/index.d.ts

@@ -0,0 +1 @@
+export * from './local-config';

package/src/lib/config/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./local-config"), exports);
+//# sourceMappingURL=index.js.map

package/src/lib/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/config/index.ts"],"names":[],"mappings":";;;AAAA,yDAA+B"}

package/src/lib/config/local-config.d.ts

@@ -0,0 +1,31 @@
+export declare const LOCAL_CONFIG_FILE_NAME = "ethlete.config.local.json";
+/**
+ * The file these keys lived in before they moved to `ethlete.config.local.json`. Still read as a
+ * fallback so an existing checkout keeps working, and reported so the developer can move them.
+ */
+export declare const LEGACY_LOCAL_CONFIG_FILE_NAME = "ethlete-agents.config.local.json";
+/**
+ * Machine-local repo topology: where the sibling checkouts this repo works with live. The file is
+ * gitignored, so every value is per-machine and never changes what anyone else sees.
+ */
+export type LocalConfig = {
+    /** Path to a local `ethlete-sdk` checkout, for reading its source or building it into this repo. */
+    sdkSourcePath?: string;
+    /** Path to the checkout of the API an app talks to, keyed by app name. `"*"` matches any app. */
+    apiRepoPaths?: Record<string, string>;
+    /** Branch that represents each API's deployed state, keyed by app name. `"*"` matches any app. */
+    apiRepoBranches?: Record<string, string>;
+};
+export type LocalConfigSource = {
+    config: LocalConfig;
+    /** The file the values came from, or `undefined` when neither file exists. */
+    fileName?: string;
+    /** True when the values came from `LEGACY_LOCAL_CONFIG_FILE_NAME`. */
+    isLegacy: boolean;
+};
+/** Reads the local config, falling back to the file the keys used to live in. */
+export declare const readLocalConfig: (root: string) => LocalConfigSource;
+export declare const configuredApiRepoPath: (config: LocalConfig, api: string) => string | undefined;
+export declare const configuredApiRepoBranch: (config: LocalConfig, api: string) => string | undefined;
+/** Resolves a configured path against the repo root, so a relative path in the file works. */
+export declare const resolveConfiguredPath: (root: string, configured: string) => string;

package/src/lib/config/local-config.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveConfiguredPath = exports.configuredApiRepoBranch = exports.configuredApiRepoPath = exports.readLocalConfig = exports.LEGACY_LOCAL_CONFIG_FILE_NAME = exports.LOCAL_CONFIG_FILE_NAME = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+exports.LOCAL_CONFIG_FILE_NAME = 'ethlete.config.local.json';
+/**
+ * The file these keys lived in before they moved to `ethlete.config.local.json`. Still read as a
+ * fallback so an existing checkout keeps working, and reported so the developer can move them.
+ */
+exports.LEGACY_LOCAL_CONFIG_FILE_NAME = 'ethlete-agents.config.local.json';
+const readJsonObject = (path) => {
+    if (!(0, fs_1.existsSync)(path))
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse((0, fs_1.readFileSync)(path, 'utf8'));
+    }
+    catch (_a) {
+        return undefined;
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+        return undefined;
+    return parsed;
+};
+/** Reads the local config, falling back to the file the keys used to live in. */
+const readLocalConfig = (root) => {
+    const current = readJsonObject((0, path_1.join)(root, exports.LOCAL_CONFIG_FILE_NAME));
+    if (current)
+        return { config: current, fileName: exports.LOCAL_CONFIG_FILE_NAME, isLegacy: false };
+    const legacy = readJsonObject((0, path_1.join)(root, exports.LEGACY_LOCAL_CONFIG_FILE_NAME));
+    if (legacy)
+        return { config: legacy, fileName: exports.LEGACY_LOCAL_CONFIG_FILE_NAME, isLegacy: true };
+    return { config: {}, isLegacy: false };
+};
+exports.readLocalConfig = readLocalConfig;
+const entryFor = (record, key) => { var _a; return (_a = record === null || record === void 0 ? void 0 : record[key]) !== null && _a !== void 0 ? _a : record === null || record === void 0 ? void 0 : record['*']; };
+const configuredApiRepoPath = (config, api) => entryFor(config.apiRepoPaths, api);
+exports.configuredApiRepoPath = configuredApiRepoPath;
+const configuredApiRepoBranch = (config, api) => entryFor(config.apiRepoBranches, api);
+exports.configuredApiRepoBranch = configuredApiRepoBranch;
+/** Resolves a configured path against the repo root, so a relative path in the file works. */
+const resolveConfiguredPath = (root, configured) => (0, path_1.isAbsolute)(configured) ? configured : (0, path_1.resolve)(root, configured);
+exports.resolveConfiguredPath = resolveConfiguredPath;
+//# sourceMappingURL=local-config.js.map

package/src/lib/config/local-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-config.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/config/local-config.ts"],"names":[],"mappings":";;;AAAA,2BAA8C;AAC9C,+BAAiD;AAEpC,QAAA,sBAAsB,GAAG,2BAA2B,CAAC;AAElE;;;GAGG;AACU,QAAA,6BAA6B,GAAG,kCAAkC,CAAC;AAuBhF,MAAM,cAAc,GAAG,CAAC,IAAY,EAA2B,EAAE;IAC/D,IAAI,CAAC,IAAA,eAAU,EAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAExC,IAAI,MAAe,CAAC;IAEpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAE7F,OAAO,MAAqB,CAAC;AAC/B,CAAC,CAAC;AAEF,iFAAiF;AAC1E,MAAM,eAAe,GAAG,CAAC,IAAY,EAAqB,EAAE;IACjE,MAAM,OAAO,GAAG,cAAc,CAAC,IAAA,WAAI,EAAC,IAAI,EAAE,8BAAsB,CAAC,CAAC,CAAC;IAEnE,IAAI,OAAO;QAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,8BAAsB,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAE3F,MAAM,MAAM,GAAG,cAAc,CAAC,IAAA,WAAI,EAAC,IAAI,EAAE,qCAA6B,CAAC,CAAC,CAAC;IAEzE,IAAI,MAAM;QAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,qCAA6B,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAE/F,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACzC,CAAC,CAAC;AAVW,QAAA,eAAe,mBAU1B;AAEF,MAAM,QAAQ,GAAG,CAAC,MAA0C,EAAE,GAAW,EAAE,EAAE,WAAC,OAAA,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAG,GAAG,CAAC,mCAAI,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAG,GAAG,CAAC,CAAA,EAAA,CAAC;AAEtG,MAAM,qBAAqB,GAAG,CAAC,MAAmB,EAAE,GAAW,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;AAAjG,QAAA,qBAAqB,yBAA4E;AAEvG,MAAM,uBAAuB,GAAG,CAAC,MAAmB,EAAE,GAAW,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;AAAtG,QAAA,uBAAuB,2BAA+E;AAEnH,8FAA8F;AACvF,MAAM,qBAAqB,GAAG,CAAC,IAAY,EAAE,UAAkB,EAAE,EAAE,CACxE,IAAA,iBAAU,EAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAA,cAAO,EAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AADrD,QAAA,qBAAqB,yBACgC"}

package/src/lib/index.d.ts

@@ -1 +1,3 @@
+export * from './api';
+export * from './config';
 export * from './release';

package/src/lib/index.js

@@ -1,5 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./api"), exports);
+tslib_1.__exportStar(require("./config"), exports);
 tslib_1.__exportStar(require("./release"), exports);
 //# sourceMappingURL=index.js.map

package/src/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/cli/src/lib/index.ts"],"names":[],"mappings":";;;AAAA,oDAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/cli/src/lib/index.ts"],"names":[],"mappings":";;;AAAA,gDAAsB;AACtB,mDAAyB;AACzB,oDAA0B"}