@stamhoofd/cli 2.122.1

package/LICENSE.md

@@ -0,0 +1,32 @@
+Free Use License for Non-Profit Organizations
+
+Copyright 2020 Codawood BV
+
+Permission is hereby granted, free of charge, to any non-profit organization with fewer than 2,000 members (each, a “Licensee”), to use this software and associated documentation files (the “Software”), subject to the following conditions:
+
+1. Eligibility:
+This license applies only if neither the Licensee nor, if applicable, its parent or umbrella organization, is already subject to an existing license for this project. For the purposes of this license, a “parent or umbrella organization” means any organization with which the Licensee is affiliated, coordinated, or represented as part of a larger collective, including but not limited to national associations or federations.
+
+2. Modifications:
+Modifications to the Software are permitted only if they are published publicly under the MIT License, covering only the modifications; the original Software remains under this license and may not be sublicensed without a separate agreement. Any modification made by a Licensee (other than modifications by the original author, its representatives, or the copyright owner) shall be deemed to be distributed under the MIT License. Submission of modifications through publicly accessible channels, including but not limited to pull requests on code repositories such as GitHub, shall be considered an explicit acknowledgment and grant by the Licensee that such modifications are made available under the MIT License. Licensees may not sublicense, transfer, or assign the rights granted under this license except as expressly permitted herein.
+
+3. Precedence of Existing Licenses:
+If the Licensee, or its parent or umbrella organization, is already subject to an existing license for this project, that license shall take precedence, and no additional free license is granted. Nothing in this license shall be construed to override any pre-existing exclusive license agreement.
+
+4. Data Protection / GDPR Responsibility:
+Licensees are solely responsible for ensuring that any processing of personal data using this software complies with applicable data protection laws, including the EU General Data Protection Regulation (GDPR).
+
+5. Termination and Revocation:
+The copyright holders may revoke this license at any time, at their sole discretion.
+
+6. Governing Law:
+This license shall be governed by and construed in accordance with the laws of Belgium, without regard to conflict of law principles.
+
+7. Third-Party Licenses:
+Certain files or components included in the Software may be governed by separate licenses, including open-source licenses, or contributed by third parties under different terms. Such files are not automatically covered by this license. Licensees are responsible for reviewing and complying with any additional license terms that apply to these files.
+
+For the purposes of this license, a “non-profit organization” means an entity recognized as non-profit under applicable law in its jurisdiction, which does not distribute profits to its members or owners.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

package/README.md

@@ -0,0 +1,365 @@
+# Stamhoofd CLI
+
+`stam` is the development CLI for this repository. It manages local setup, shared services, app processes, development configuration, database helpers, SSO helpers, tests, and cleanup.
+
+## Quick Start
+
+```bash
+yarn install
+yarn stam setup
+yarn stam dev all
+```
+
+Run `yarn stam setup shell` to install the CLI alias `stam` in your .zshrc or .bashrc (that removes the need to type `yarn` and the need to always run commands in the project root).
+
+Open the dashboard URL printed by the CLI, or run `yarn stam status` to see active services, instances, URLs, and credentials.
+
+Run `yarn stam --help` or `yarn stam <topic> --help` for command help.
+
+## For CLI Users
+
+### Commands
+
+| Area        | Command                              | Purpose                                                                  |
+| ----------- | ------------------------------------ | ------------------------------------------------------------------------ |
+| Build       | `yarn stam build`                    | Build shared packages and all app packages for the selected environment. |
+| Setup       | `yarn stam setup`                    | Check the machine and offer recommended setup fixes.                     |
+| Setup       | `yarn stam setup node`               | Install the Node.js version from `.nvmrc` using fnm or nvm.              |
+| Setup       | `yarn stam setup dns`                | Configure local `.stamhoofd` DNS.                                        |
+| Setup       | `yarn stam setup cert`               | Trust the local Caddy HTTPS authority.                                   |
+| Development | `yarn stam dev all`                  | Start shared services and the full app stack.                            |
+| Development | `yarn stam dev backend`              | Start backend apps for the current instance.                             |
+| Development | `yarn stam dev frontend`             | Start frontend apps only.                                                |
+| Development | `yarn stam dev instance`             | Start this workspace instance using shared services.                     |
+| Services    | `yarn stam services up`              | Start shared Docker services.                                            |
+| Services    | `yarn stam services status`          | Show shared service status.                                              |
+| Services    | `yarn stam services logs`            | Tail shared service logs.                                                |
+| Services    | `yarn stam services restart`         | Restart shared services with interactive progress output.                |
+| Services    | `yarn stam services down`            | Stop shared services.                                                    |
+| Services    | `yarn stam services stop`            | Alias for `yarn stam services down`.                                     |
+| Status      | `yarn stam status`                   | Show shared services, active instances, URLs, and credentials.           |
+| Config      | `yarn stam config explain`           | Explain resolved instance config.                                        |
+| Config      | `yarn stam config print`             | Print resolved domains and backend environment values as JSON.           |
+| Database    | `yarn stam db shell`                 | Open a MySQL shell for the current local database.                       |
+| Database    | `yarn stam db migrate`               | Build shared packages and run migrations.                                |
+| SSO         | `yarn stam sso config`               | Print local SSO client, user, and issuer settings.                       |
+| SSO         | `yarn stam sso start <redirect-uri>` | Start Keycloak and import the local realm.                               |
+| SSO         | `yarn stam sso logs`                 | Tail Keycloak logs.                                                      |
+| SSO         | `yarn stam sso stop`                 | Stop the local Keycloak container.                                       |
+| Tests       | `yarn stam test unit`                | Run unit tests with isolated MySQL.                                      |
+| Tests       | `yarn stam test e2e`                 | Run Playwright tests.                                                    |
+| Tests       | `yarn stam test all --ci`            | Run unit and E2E tests in CI mode.                                       |
+| Checks      | `yarn stam check lint`               | Run ESLint across the monorepo.                                          |
+| Checks      | `yarn stam check typecheck`          | Run TypeScript checks across the monorepo.                               |
+| Checks      | `yarn stam check all`                | Run build, lint, typecheck, unit tests, and E2E tests.                   |
+| Cleanup     | `yarn stam clean build`              | Remove build artifacts.                                                  |
+| Cleanup     | `yarn stam clean db`                 | Drop the selected local MySQL database after confirmation.               |
+| Cleanup     | `yarn stam clean sso`                | Stop the local SSO server.                                               |
+| Cleanup     | `yarn stam clean services`           | Stop shared services.                                                    |
+| Cleanup     | `yarn stam clean all`                | Clean build artifacts and stop shared services.                          |
+
+### Development Configuration
+
+`shared/cli` owns local development configuration. Backend and frontend development builds load domains, ports, database settings, storage settings, and app environment values from `@stamhoofd/cli`.
+
+The main config contract lives in `src/config/development-config.ts`. Keep local-development settings there first, then consume the resolved config from commands, workflows, Caddy, SSO, Stripe, status output, or app bootstrapping.
+
+Inspect the current config with:
+
+```bash
+yarn stam config explain
+yarn stam config print
+yarn stam config print --env keeo
+```
+
+### Instances And Ports
+
+The CLI infers an instance from the workspace, selected environment, and optional overrides.
+
+Useful flags:
+
+- `--env <name>` selects the development environment. The default is `stamhoofd`.
+- `--name <name>` overrides the inferred instance name.
+- `--verbose` prints extra diagnostics and commands.
+
+Useful environment variables:
+
+- `STAMHOOFD_WORKSPACE_NAME` overrides the workspace name.
+- `STAMHOOFD_PRIMARY_INSTANCE=1` forces primary-instance behavior.
+- `STAMHOOFD_INSTANCE_PREFIX` overrides the domain prefix.
+- `STAMHOOFD_PORT_OFFSET` overrides the deterministic port offset.
+- `STAMHOOFD_DOMAIN` overrides the shared local domain, defaulting to `stamhoofd`.
+- `MYSQL_PORT` overrides the local MySQL host port, defaulting to `3307`.
+- `STAMHOOFD_MYSQL_INNODB_BUFFER_POOL_SIZE` tunes the MySQL container InnoDB buffer pool size (e.g. `512M`, `1G`), defaulting to `4G`.
+- `STAMHOOFD_MYSQL_INNODB_BUFFER_POOL_INSTANCES` tunes the MySQL container InnoDB buffer pool instances defaulting to `4`.
+- `STAMHOOFD_MYSQL_SORT_BUFFER_SIZE` tunes the MySQL container sort buffer size (e.g. `8M`), defaulting to `2M`.
+- `PUBLIC_IP`: Publish DNS records to your computers public IP address, and make Caddy listen on 0.0.0.0 instead of localhost. Useful for testing on local devices. E.g. `PUBLIC_IP=192.168.1.7 stam services restart` `PUBLIC_IP=192.168.1.7 stam dev all`
+
+The primary `stamhoofd` instance uses base ports. With Git, the primary instance is the first worktree in `git worktree list --porcelain`. With jj, it is the first workspace in `jj workspace list`. Other worktrees and workspaces get deterministic offsets based on the workspace name so multiple workspaces can run on the same machine without changing databases when branches change.
+
+When needing a heavy duty MySQL instance to test migrations, you can restart MySQL using:
+
+```
+STAMHOOFD_MYSQL_INNODB_BUFFER_POOL_INSTANCES=10 \
+STAMHOOFD_MYSQL_SORT_BUFFER_SIZE=64M \
+STAMHOOFD_MYSQL_INNODB_BUFFER_POOL_SIZE=16G \
+stam services restart
+```
+
+### Shared Services
+
+Shared services run as Docker containers:
+
+- MySQL: `stamhoofd-mysql`
+- MailDev: `stamhoofd-maildev`
+- RustFS: `stamhoofd-rustfs`
+- CoreDNS: `stamhoofd-coredns`
+- Caddy: `stamhoofd-caddy`
+
+The setup is intentionally different where Docker behaves differently:
+
+- Linux runs Caddy on unprivileged ports `8080/8443` and uses `sudo iptables` redirects from `80/443`.
+- Linux configures split DNS through `systemd-resolved`, pointing `.stamhoofd` to CoreDNS on `127.0.0.1:1053`.
+- macOS uses Docker Desktop bridge networking for Caddy, publishes `80/443` directly, and proxies back to host app ports through `host.docker.internal`.
+- macOS configures `/etc/resolver/stamhoofd` with `nameserver 127.0.0.1`, so only the `stamhoofd` resolver domain and its subdomains use local CoreDNS on port `53`.
+- MySQL listens on host port `3307` by default and still uses container port `3306`.
+
+Start and inspect them with:
+
+```bash
+yarn stam services up
+yarn stam services status
+yarn stam services logs
+```
+
+Stop them with:
+
+```bash
+yarn stam services down
+```
+
+### Local SSO
+
+Use `yarn stam sso config` to print the issuer, client credentials, test user, and example command.
+
+Start Keycloak with the redirect URI copied from the app:
+
+```bash
+yarn stam sso start "https://<organization-id>.api.stamhoofd/openid/callback"
+```
+
+The command imports a local realm with the printed client and test user.
+
+### Tests
+
+Unit tests start an isolated MySQL container, create `stamhoofd-tests`, run tests with the mapped `DB_PORT`, and remove the container afterward:
+
+```bash
+yarn stam test unit
+```
+
+Run Playwright tests with:
+
+```bash
+yarn stam test e2e
+```
+
+The e2e command keeps its MySQL container and data volume between runs so migrated worker databases can be reused. Reset that persistent e2e database with:
+
+```bash
+yarn stam test e2e --clear
+```
+
+Use `--workers <number>` to override Playwright's default worker count for a run.
+Use `--extra` to include tests tagged `@extra`.
+
+Run the full validation flow with:
+
+```bash
+yarn stam check all
+```
+
+## For CLI Maintainers
+
+The sections below are for contributors working on `shared/cli` itself rather than only using the CLI.
+
+### Architecture Overview
+
+`shared/cli` is organized around a small set of responsibilities:
+
+- `src/commands/`: oclif command entrypoints that parse flags and dispatch work.
+- `src/workflows/`: multi-step flows such as machine setup or starting a full development session.
+- `src/services/`: shared Docker service abstractions, service definitions, and service orchestration.
+- `src/config/`: development configuration and generated infrastructure config such as Caddy routing.
+- `src/context/`: workspace, instance, and port resolution.
+- `src/runtime/`: process execution, output rendering, manifests, help rendering, and external CLI helpers.
+
+The intended flow is:
+
+1. Commands parse user input.
+2. Commands create a `CliContext`.
+3. Commands call workflows, runtime helpers, or services.
+4. Workflows orchestrate long-running behavior, service startup, manifests, and output.
+5. Services encapsulate Docker-specific behavior.
+
+Try to keep that direction intact. Commands should stay thin, workflows should own coordination, and runtime utilities should stay generic enough to be reused from multiple commands.
+
+### Runtime Concepts
+
+Some runtime concepts show up across many commands and are worth understanding before changing behavior.
+
+#### Instance Inference
+
+The CLI computes a `CliContext` from:
+
+- the repository root
+- the selected environment
+- the workspace name
+- optional overrides such as `--name` or environment variables
+
+That context decides the instance name, domain prefix, whether the instance is considered primary, and the port offset used by local apps.
+
+#### Port Allocation
+
+Base ports come from `src/context/ports.ts`.
+
+For secondary instances, `src/context/instance.ts` and `src/context/port-allocation.ts` assign deterministic offsets so multiple clones of the repository can run at once. If a computed range is occupied, the CLI steps to the next bucket until it finds a free range or fails with a clear error.
+
+#### Manifests
+
+The CLI writes JSON manifests under `.development/cli/generated` to describe what is currently running.
+
+- instance manifests let `stam status` and Caddy discover active local instances
+- the shared services manifest records that shared infrastructure was started
+
+When changing startup or shutdown behavior, keep manifest creation and cleanup in sync or the CLI will show stale instances or stale routes.
+
+#### Output Flow
+
+Long-running commands do not write directly to `console.log` unless they intentionally bypass the CLI output system. Instead they use runtime helpers so status lines, live output, tables, and command logging can coexist without corrupting terminal output.
+
+When changing interactive output, check `src/runtime/live-output.ts`, `src/runtime/output-target.ts`, and `src/runtime/ux.ts` together.
+
+### Service Model
+
+Shared infrastructure is modeled through `ServiceDefinition` in `src/services/service.ts`.
+
+The common patterns are:
+
+- `DockerService`: base class for services that start through `docker run`
+- `SharedDockerService`: convenience base for shared services without per-command options
+- `manager.ts`: orchestration for status, start, stop, restart, log tailing, and interactive tables
+- `registry.ts`: the ordered list of shared services used by the CLI
+
+The normal lifecycle is:
+
+1. Read current status.
+2. Optionally prepare files or derived config.
+3. Decide whether an existing container can be reused.
+4. Stop the old container if needed.
+5. Run setup hooks.
+6. Start the container.
+7. Run post-start hooks.
+8. Return any environment variables needed by callers.
+
+When adding a service, keep Docker-specific behavior inside the service class instead of spreading it across commands or workflows.
+
+As a rule of thumb:
+
+- add a new service definition in `src/services/definitions/`
+- register it in `src/services/registry.ts` if it is part of the shared baseline
+- use `startServicesInteractive` or `restartServicesInteractive` when the command should show progress for multiple services
+- use `startServices` or `stopServices` when the caller already controls user-facing output
+
+### Development Config Contract
+
+`src/config/development-config.ts` is the main contract exported by `@stamhoofd/cli` for the rest of the monorepo.
+
+It is responsible for resolving:
+
+- local domains
+- port numbers
+- backend environment variables
+- frontend and backend app environment objects
+- environment-specific presets such as platform name or user mode
+
+Prefer putting local-development defaults there first and reading the resolved config elsewhere instead of re-deriving values in commands, services, app bootstrapping, or generated infrastructure config.
+
+Good candidates for this file:
+
+- anything that should stay consistent across app startup, status output, Caddy routing, and service helpers
+- environment-specific local development behavior
+- values consumed by backend or frontend dev builds through `@stamhoofd/cli`
+
+Bad candidates for this file:
+
+- one-off command-only formatting
+- transient workflow state
+- Docker lifecycle logic
+- generic runtime helpers that are unrelated to development configuration
+
+### Working On The CLI
+
+`yarn install` builds `shared/cli` so normal CLI startup stays fast. When changing CLI source code, use `stam-dev` to rebuild before running:
+
+```bash
+yarn stam-dev --help
+```
+
+For CLI-only changes, run:
+
+```bash
+yarn --cwd shared/cli -s build
+yarn --cwd shared/cli -s lint
+yarn --cwd shared/cli -s test
+```
+
+CLI tests live next to source files as `*.test.ts`.
+
+After changing CLI behavior, validate at least the package-local checks:
+
+```bash
+yarn --cwd shared/cli -s test
+yarn --cwd shared/cli -s build
+```
+
+For command-surface changes, it is also useful to compare the generated help output with the README:
+
+```bash
+yarn stam --help
+yarn stam services --help
+yarn stam clean --help
+```
+
+## Troubleshooting
+
+Use `yarn stam setup` first. It checks Node, Docker, Caddy, DNS, and certificate trust.
+
+- **The active Node.js version differs from `.nvmrc`**
+
+    Run `source .development/install-node.sh`. The script uses [fnm](https://github.com/Schniz/fnm) or [nvm](https://github.com/nvm-sh/nvm), whichever is available. `stam status` also reports this mismatch, and `stam dev` will stop before starting processes with the wrong version.
+
+If that does not tell you enough, use the first matching case below.
+
+- DNS names like `dashboard.stamhoofd` do not resolve:
+  Run `yarn stam setup dns`, then retry `yarn stam setup check`.
+- `yarn stam setup` reports missing privileged port redirects on Linux:
+  Let the setup command apply the recommended `sudo iptables` rules, then retry.
+- HTTPS works badly or the browser does not trust local certificates:
+  Run `yarn stam setup cert`, then retry `yarn stam setup check`.
+- Docker commands fail or services do not start:
+  Start Docker, retry the command, and use `yarn stam services status` to confirm which service is still down.
+- Caddy fails to reload or URLs do not open locally:
+  Check `yarn stam services status`, then try `yarn stam services restart`.
+- URLs, instance names, or ports look wrong:
+  Run `yarn stam status`, `yarn stam config explain`, and check whether `--env`, `--name`, or environment variables such as `STAMHOOFD_WORKSPACE_NAME` are overriding the inferred instance.
+- Two workspaces conflict on ports:
+  Check whether `STAMHOOFD_PORT_OFFSET` is forcing the same offset in multiple clones. Otherwise rerun the command and let automatic port allocation pick another bucket.
+- Local database state is broken:
+  Use `yarn stam clean db` for the selected instance or `yarn stam clean all` if generated state is broadly stale.
+- Shared services state is broken:
+  Use `yarn stam services restart`, or `yarn stam clean services` if volumes or generated service files need to be cleared manually.
+- SSO redirect or Keycloak issues appear locally:
+  Re-run `yarn stam sso config`, make sure the redirect URI still ends in `/openid/callback`, then restart SSO with `yarn stam sso start "<redirect-uri>"`.
+- Stale build or type errors keep appearing after code changes:
+  Run `yarn build:shared`, then retry the CLI command or app startup flow.

package/bin/stam.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import { run } from '@oclif/core';
+
+async function main() {
+    const args = process.argv.slice(2);
+
+    if (args.length === 0) {
+        await run(['--help'], import.meta.url);
+        return;
+    }
+
+    await run(args, import.meta.url);
+}
+
+main().catch((error) => {
+    const exitCode = typeof error?.exitCode === 'number' ? error.exitCode : 1;
+    console.error(error);
+    process.exitCode = exitCode;
+});

package/dist/base-command.d.ts

@@ -0,0 +1,22 @@
+import { Command } from '@oclif/core';
+import type { CliContext } from './context/create-context.js';
+export declare abstract class BaseCommand extends Command {
+    static verboseFlags: {
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    static environmentFlags: {
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        env: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    static instanceFlags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        env: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    protected createContext(flags: {
+        env?: string;
+        name?: string;
+        verbose?: boolean;
+    }): Promise<CliContext>;
+}
+//# sourceMappingURL=base-command.d.ts.map

package/dist/base-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-command.d.ts","sourceRoot":"","sources":["../src/base-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,8BAAsB,WAAY,SAAQ,OAAO;IAC7C,MAAM,CAAC,YAAY;;MAEjB;IAEF,MAAM,CAAC,gBAAgB;;;MAGrB;IAEF,MAAM,CAAC,aAAa;;;;MAGlB;cAEc,aAAa,CAAC,KAAK,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC;CAOhH"}

package/dist/base-command.js

@@ -0,0 +1,23 @@
+import { Command, Flags } from '@oclif/core';
+import { createContext } from './context/create-context.js';
+export class BaseCommand extends Command {
+    static verboseFlags = {
+        verbose: Flags.boolean({ description: 'Print extra diagnostics while running', default: false }),
+    };
+    static environmentFlags = {
+        env: Flags.string({ description: 'Environment to use, such as stamhoofd or keeo', default: 'stamhoofd' }),
+        ...BaseCommand.verboseFlags,
+    };
+    static instanceFlags = {
+        ...BaseCommand.environmentFlags,
+        name: Flags.string({ description: 'Instance name to use instead of the inferred workspace name' }),
+    };
+    async createContext(flags) {
+        return await createContext({
+            env: flags.env ?? 'stamhoofd',
+            instanceName: flags.name,
+            verbose: flags.verbose ?? false,
+        });
+    }
+}
+//# sourceMappingURL=base-command.js.map

package/dist/base-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-command.js","sourceRoot":"","sources":["../src/base-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAG5D,MAAM,OAAgB,WAAY,SAAQ,OAAO;IAC7C,MAAM,CAAC,YAAY,GAAG;QAClB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,uCAAuC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;KACnG,CAAC;IAEF,MAAM,CAAC,gBAAgB,GAAG;QACtB,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,+CAA+C,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;QACzG,GAAG,WAAW,CAAC,YAAY;KAC9B,CAAC;IAEF,MAAM,CAAC,aAAa,GAAG;QACnB,GAAG,WAAW,CAAC,gBAAgB;QAC/B,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,6DAA6D,EAAE,CAAC;KACrG,CAAC;IAEQ,KAAK,CAAC,aAAa,CAAC,KAAyD;QACnF,OAAO,MAAM,aAAa,CAAC;YACvB,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,WAAW;YAC7B,YAAY,EAAE,KAAK,CAAC,IAAI;YACxB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,KAAK;SAClC,CAAC,CAAC;IACP,CAAC"}

package/dist/command-flags.d.ts

@@ -0,0 +1,8 @@
+export declare const verboseFlag: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+export declare const servicesOptionFlag: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+export declare const stripeFlag: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+export declare const yesFlag: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+export declare const dryRunFlag: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+export declare const openFlag: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+export declare const ciFlag: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+//# sourceMappingURL=command-flags.d.ts.map

package/dist/command-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-flags.d.ts","sourceRoot":"","sources":["../src/command-flags.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,uDAGtB,CAAC;AAEH,eAAO,MAAM,kBAAkB,uDAG7B,CAAC;AAEH,eAAO,MAAM,UAAU,uDAIrB,CAAC;AAEH,eAAO,MAAM,OAAO,uDAIlB,CAAC;AAEH,eAAO,MAAM,UAAU,uDAGrB,CAAC;AAEH,eAAO,MAAM,QAAQ,uDAGnB,CAAC;AAEH,eAAO,MAAM,MAAM,uDAGjB,CAAC"}

package/dist/command-flags.js

@@ -0,0 +1,32 @@
+import { Flags } from '@oclif/core';
+export const verboseFlag = Flags.boolean({
+    description: 'Print extra diagnostics while running',
+    default: false,
+});
+export const servicesOptionFlag = Flags.boolean({
+    allowNo: true,
+    description: 'Start shared services before the selected target',
+});
+export const stripeFlag = Flags.boolean({
+    allowNo: true,
+    default: true,
+    description: 'Start a Stripe listener for the selected instance',
+});
+export const yesFlag = Flags.boolean({
+    char: 'y',
+    default: false,
+    description: 'Skip confirmation prompts',
+});
+export const dryRunFlag = Flags.boolean({
+    default: false,
+    description: 'Preview changes without applying them',
+});
+export const openFlag = Flags.boolean({
+    default: false,
+    description: 'Open the dashboard in your browser',
+});
+export const ciFlag = Flags.boolean({
+    default: false,
+    description: 'Run in non-interactive CI-style mode',
+});
+//# sourceMappingURL=command-flags.js.map

package/dist/command-flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-flags.js","sourceRoot":"","sources":["../src/command-flags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC;IACrC,WAAW,EAAE,uCAAuC;IACpD,OAAO,EAAE,KAAK;CACjB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC,OAAO,CAAC;IAC5C,OAAO,EAAE,IAAI;IACb,WAAW,EAAE,kDAAkD;CAClE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC;IACpC,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,IAAI;IACb,WAAW,EAAE,mDAAmD;CACnE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IACjC,IAAI,EAAE,GAAG;IACT,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,2BAA2B;CAC3C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC;IACpC,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,uCAAuC;CACvD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC;IAClC,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,oCAAoC;CACpD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC;IAChC,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,sCAAsC;CACtD,CAAC,CAAC"}

package/dist/commands/build.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../base-command.js';
+export default class Build extends BaseCommand {
+    static summary: string;
+    static description: string;
+    static examples: string[];
+    static flags: {
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        env: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=build.d.ts.map

package/dist/commands/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,WAAW;IAC1C,MAAM,CAAC,OAAO,SAAkC;IAChD,MAAM,CAAC,WAAW,SAAgH;IAClI,MAAM,CAAC,QAAQ,WAGb;IACF,MAAM,CAAC,KAAK;;;MAAgC;IAEtC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/dist/commands/build.js

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../base-command.js';
+import { buildAll } from '../runtime/monorepo-runner.js';
+export default class Build extends BaseCommand {
+    static summary = 'Build all Stamhoofd packages';
+    static description = 'Use this when generated artifacts are stale or before running broader checks that depend on a clean build.';
+    static examples = [
+        'stam build --env keeo',
+        'stam build --verbose',
+    ];
+    static flags = BaseCommand.environmentFlags;
+    async run() {
+        const { flags } = await this.parse(Build);
+        await buildAll(await this.createContext(flags));
+    }
+}
+//# sourceMappingURL=build.js.map

package/dist/commands/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAEzD,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,WAAW;IAC1C,MAAM,CAAC,OAAO,GAAG,8BAA8B,CAAC;IAChD,MAAM,CAAC,WAAW,GAAG,4GAA4G,CAAC;IAClI,MAAM,CAAC,QAAQ,GAAG;QACd,uBAAuB;QACvB,sBAAsB;KACzB,CAAC;IACF,MAAM,CAAC,KAAK,GAAG,WAAW,CAAC,gBAAgB,CAAC;IAE5C,KAAK,CAAC,GAAG;QACL,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,QAAQ,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IACpD,CAAC"}

package/dist/commands/check/all.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base-command.js';
+export default class CheckAll extends BaseCommand {
+    static summary: string;
+    static description: string;
+    static examples: string[];
+    static flags: {
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        env: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=all.d.ts.map

package/dist/commands/check/all.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"all.d.ts","sourceRoot":"","sources":["../../../src/commands/check/all.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,WAAW;IAC7C,MAAM,CAAC,OAAO,SAA+B;IAC7C,MAAM,CAAC,WAAW,SAA2G;IAC7H,MAAM,CAAC,QAAQ,WAGb;IACF,MAAM,CAAC,KAAK;;;MAAgC;IAEtC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAS7B"}

package/dist/commands/check/all.js

@@ -0,0 +1,21 @@
+import { BaseCommand } from '../../base-command.js';
+import { buildAll, lint, testE2e, testUnit, typecheck } from '../../runtime/monorepo-runner.js';
+export default class CheckAll extends BaseCommand {
+    static summary = 'Run all validation checks';
+    static description = 'Use this before pushing when you want roughly the same broad safety net as the main automated checks.';
+    static examples = [
+        'stam check all',
+        'stam check all --env keeo',
+    ];
+    static flags = BaseCommand.environmentFlags;
+    async run() {
+        const { flags } = await this.parse(CheckAll);
+        const context = await this.createContext(flags);
+        await buildAll(context);
+        await lint(context);
+        await typecheck(context);
+        await testUnit(context, true);
+        await testE2e(context, { ci: true, clear: false, ui: false });
+    }
+}
+//# sourceMappingURL=all.js.map

package/dist/commands/check/all.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"all.js","sourceRoot":"","sources":["../../../src/commands/check/all.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAEhG,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,WAAW;IAC7C,MAAM,CAAC,OAAO,GAAG,2BAA2B,CAAC;IAC7C,MAAM,CAAC,WAAW,GAAG,uGAAuG,CAAC;IAC7H,MAAM,CAAC,QAAQ,GAAG;QACd,gBAAgB;QAChB,2BAA2B;KAC9B,CAAC;IACF,MAAM,CAAC,KAAK,GAAG,WAAW,CAAC,gBAAgB,CAAC;IAE5C,KAAK,CAAC,GAAG;QACL,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;QACxB,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;QACzB,MAAM,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC9B,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAClE,CAAC"}

package/dist/commands/check/index.d.ts

@@ -0,0 +1,8 @@
+import { Command } from '@oclif/core';
+export default class Check extends Command {
+    static summary: string;
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/check/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/check/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,OAAO;IACtC,MAAM,CAAC,OAAO,SAA2C;IACzD,MAAM,CAAC,WAAW,SAAmH;IACrI,MAAM,CAAC,QAAQ,WAIb;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/commands/check/index.js

@@ -0,0 +1,15 @@
+import { Command } from '@oclif/core';
+import { showHelp } from '../../runtime/show-help.js';
+export default class Check extends Command {
+    static summary = 'Run build, lint, typecheck, and tests';
+    static description = 'Use these commands to run build, lint, type checks, or the full validation suite locally before opening a PR.';
+    static examples = [
+        'stam check lint',
+        'stam check typecheck',
+        'stam check all',
+    ];
+    async run() {
+        await showHelp(this.config, ['check']);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/check/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/check/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEtD,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,OAAO;IACtC,MAAM,CAAC,OAAO,GAAG,uCAAuC,CAAC;IACzD,MAAM,CAAC,WAAW,GAAG,+GAA+G,CAAC;IACrI,MAAM,CAAC,QAAQ,GAAG;QACd,iBAAiB;QACjB,sBAAsB;QACtB,gBAAgB;KACnB,CAAC;IAEF,KAAK,CAAC,GAAG;QACL,MAAM,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3C,CAAC"}