@studiometa/forge-cli 0.5.1 → 0.5.3

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

@@ -1 +1 @@
-{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/commands/completion.ts"],"names":[],"mappings":"AAAA;;GAEG;AAszBH,wBAAgB,kBAAkB,IAAI,IAAI,CA2CzC;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAM,GACxD,IAAI,CAoEN"}
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/commands/completion.ts"],"names":[],"mappings":"AAAA;;GAEG;AA4zBH,wBAAgB,kBAAkB,IAAI,IAAI,CA2CzC;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAM,GACxD,IAAI,CAoEN"}

package/dist/commands/servers/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/commands/servers/command.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,oBAAoB,6GAU/B,CAAC"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/commands/servers/command.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,oBAAoB,6GAW/B,CAAC"}

package/dist/commands/servers/handlers.d.ts

@@ -11,6 +11,11 @@ export declare function serversList(ctx: CommandContext): Promise<void>;
  * Get a single server by ID or name.
  */
 export declare function serversGet(args: string[], ctx: CommandContext): Promise<void>;
+/**
+ * Print the public key of the `forge` user of a server (`~/.ssh/id_rsa.pub`), the key that
+ * Forge uses to clone repositories: add it to the git host before you create a site.
+ */
+export declare function serversPublicKey(args: string[], ctx: CommandContext): Promise<void>;
 /**
  * Create a server. Defaults to a Custom VPS app server on Ubuntu 26.04.
  */

package/dist/commands/servers/handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/commands/servers/handlers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKvD;;GAEG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBpE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAcnF;AAID;;GAEG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA+DtE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CActF"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/commands/servers/handlers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMvD;;GAEG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBpE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAcnF;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBzF;AAID;;GAEG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA+DtE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CActF"}

package/dist/commands/servers/help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/commands/servers/help.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAyGzD"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/commands/servers/help.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAgIzD"}

package/dist/commands/sites/apply/apply.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Read the state of Forge for a site file, and run a plan against Forge.
+ */
+import type { CliExecutorContext } from "../../../context.ts";
+import { CliError } from "../../../errors.ts";
+import { type Change, type Plan, type RemoteState, type Site } from "./plan.ts";
+import type { SiteFile } from "./site-file.ts";
+/** Error of `apply` that is not a validation error, e.g. a site that never gets installed. */
+export declare class ApplyError extends CliError {
+    readonly code = "APPLY_ERROR";
+    readonly isRecoverable = false;
+}
+/**
+ * Resolve the server of the site file, always with an exact name (never a partial match).
+ */
+export declare function resolveApplyServer(server: string | number, ctx: CliExecutorContext): Promise<string>;
+/**
+ * The site named `domain` on the server, compared without case. A partial match never counts.
+ */
+export declare function findSite(sites: Site[], domain: string): Site | null;
+/**
+ * Read from Forge what the site file manages, and nothing else.
+ */
+export declare function readRemoteState(file: SiteFile, serverId: string, ctx: CliExecutorContext): Promise<RemoteState>;
+/**
+ * Read the Nginx configuration of a site on Forge and render the Nginx file for the site.
+ */
+export declare function readNginx(template: string, serverId: string, site: Site, ctx: CliExecutorContext): Promise<{
+    remote: string;
+    rendered: string;
+}>;
+/**
+ * Exit with a validation error when the site does not exist and the site file cannot create it.
+ */
+export declare function assertCanCreateSite(file: SiteFile, state: RemoteState): void;
+/** A random password for a database user: 32 characters, letters and digits only. */
+export declare function generatePassword(): string;
+/** Write a value for a .env file, quoted when it needs quotes. */
+export declare function formatEnvValue(value: string): string;
+/**
+ * Set .env variables: replace the line of a variable that exists, append the others.
+ */
+export declare function setEnvValues(content: string, values: Map<string, string>): string;
+export interface ApplyOptions {
+    /** Wait between two reads of a new site; injectable for tests. */
+    sleep?: (ms: number) => Promise<void>;
+    /** Time between two reads of a new site, in ms. */
+    pollIntervalMs?: number;
+    /** Time to wait for a new site to be installed, in ms. */
+    timeoutMs?: number;
+    /** Called before each change. */
+    onChange?: (change: Change) => void;
+    /** Generate a password; injectable for tests. */
+    generatePassword?: () => string;
+}
+/**
+ * Apply a site file: create the site when it does not exist and wait until Forge installs it,
+ * then read the state again and run the other changes. Returns the plan that ran first.
+ */
+export declare function applySiteFile(file: SiteFile, serverId: string, ctx: CliExecutorContext, options?: ApplyOptions): Promise<Plan>;
+//# sourceMappingURL=apply.d.ts.map

package/dist/commands/sites/apply/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../../src/commands/sites/apply/apply.ts"],"names":[],"mappings":"AAAA;;GAEG;AA4BH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAmB,MAAM,oBAAoB,CAAC;AAI/D,OAAO,EACL,KAAK,MAAM,EACX,KAAK,IAAI,EACT,KAAK,WAAW,EAChB,KAAK,IAAI,EAGV,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,8FAA8F;AAC9F,qBAAa,UAAW,SAAQ,QAAQ;IACtC,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,aAAa,SAAS;CAChC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEnE;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,WAAW,CAAC,CAsCtB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAO/C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAQ5E;AAED,qFAAqF;AACrF,wBAAgB,gBAAgB,IAAI,MAAM,CAUzC;AAED,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAiBjF;AAED,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,MAAM,CAAC;CACjC;AAmOD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,kBAAkB,EACvB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAwCf"}

package/dist/commands/sites/apply/handler.d.ts

@@ -0,0 +1,8 @@
+import type { CommandContext } from "../../../context.ts";
+import { type ApplyOptions } from "./apply.ts";
+/**
+ * `forge sites apply --file site.json [--check]`: make a Forge site match a site file.
+ * With `--check`, print the plan and exit 1 when Forge differs, without any change.
+ */
+export declare function sitesApply(ctx: CommandContext, applyOptions?: ApplyOptions): Promise<void>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/commands/sites/apply/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/commands/sites/apply/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,EACL,KAAK,YAAY,EAKlB,MAAM,YAAY,CAAC;AAIpB;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,cAAc,EACnB,YAAY,GAAE,YAAiB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAoDf"}

package/dist/commands/sites/apply/nginx.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The Nginx file of a site file: an Nginx configuration with the template variables of Forge,
+ * e.g. `{{ PROXY_PASS }}`, rendered locally with the values of the site.
+ * See https://forge.laravel.com/docs/servers/nginx-templates
+ */
+import type { ServerAttributes } from "@studiometa/forge-api";
+import { type Site } from "./plan.ts";
+/** The variables of Forge Nginx templates. Forge accepts spaces inside the braces. */
+export declare const NGINX_VARIABLES: readonly ["DIRECTORY", "DOMAINS", "PATH", "PORT", "PORT_V6", "PROXY_PASS", "ROOT_PATH", "SERVER_PUBLIC_IP", "SERVER_PRIVATE_IP", "SITE", "SITE_ID", "USER"];
+export type NginxVariable = (typeof NGINX_VARIABLES)[number];
+/** The names of the variables in a template, each once, in order. */
+export declare function templateVariables(template: string): string[];
+/**
+ * Exit with a validation error when the template has a variable that Forge does not define.
+ */
+export declare function assertNginxTemplate(template: string, source: string): void;
+/** True when rendering the template needs the attributes of the server. */
+export declare function needsServer(template: string): boolean;
+/** `PHP 8.3`, `php83` and `php8.3` all give `8.3`. */
+export declare function phpSocketVersion(version: string): string;
+export type NginxServer = Pick<ServerAttributes, "ip_address" | "private_ip_address">;
+/**
+ * The value of each variable for a site, as Forge renders its templates.
+ * A server is needed only for the `SERVER_*` variables.
+ */
+export declare function nginxValues(site: Site, server?: NginxServer | null): Record<NginxVariable, string>;
+/**
+ * Replace each variable of the template with its value for the site.
+ */
+export declare function renderNginx(template: string, site: Site, server?: NginxServer | null): string;
+//# sourceMappingURL=nginx.d.ts.map

package/dist/commands/sites/apply/nginx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nginx.d.ts","sourceRoot":"","sources":["../../../../src/commands/sites/apply/nginx.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAI9D,OAAO,EAAE,KAAK,IAAI,EAAqB,MAAM,WAAW,CAAC;AAEzD,sFAAsF;AACtF,eAAO,MAAM,eAAe,YAC1B,WAAW,EACX,SAAS,EACT,MAAM,EACN,MAAM,EACN,SAAS,EACT,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,MAAM,EACN,SAAS,EACT,MAAM,CACE,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAO7D,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAE5D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAU1E;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,oBAAoB,CAAC,CAAC;AAEtF;;;GAGG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,IAAI,EACV,MAAM,GAAE,WAAW,GAAG,IAAW,GAChC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAyB/B;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,IAAI,EACV,MAAM,GAAE,WAAW,GAAG,IAAW,GAChC,MAAM,CAKR"}

package/dist/commands/sites/apply/ownership.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Path and command helpers of `forge sites apply`: normalize commands so that
+ * equivalent spellings compare equal, and find which site owns a daemon or a scheduled job.
+ *
+ * Ownership is strict on purpose: `apply` deletes the workers and scheduled jobs of a site
+ * that the site file does not declare, and a server often hosts many sites.
+ */
+/** A site, as far as ownership is concerned. */
+export interface SiteRoots {
+    id: number;
+    /** Absolute paths that belong to the site, e.g. `/home/forge/example.com`. */
+    roots: string[];
+}
+/**
+ * Normalize an absolute path: resolve `.` and `..`, collapse repeated slashes
+ * and drop the trailing slash.
+ */
+export declare function normalizePath(path: string): string;
+/**
+ * Whether `path` is `root` or inside it, compared on whole path segments:
+ * `/home/forge/a.com` contains `/home/forge/a.com/current` but not `/home/forge/a.com-staging`.
+ */
+export declare function isPathInside(path: string, root: string): boolean;
+/**
+ * Resolve `path` against `base` when it is relative.
+ */
+export declare function resolvePath(base: string, path: string): string;
+/**
+ * Whether a shell command uses `root` as a whole path: `root` must start the command or follow
+ * a space, a quote, `=` or a shell operator, and must end the command or be followed by `/`,
+ * a space, a quote or a shell operator. `/home/forge/a.com` is not found in
+ * `/home/forge/a.com-staging/artisan`, `/home/forge/a.com.old` or `/home/forge/*`.
+ */
+export declare function commandUsesPath(command: string, root: string): boolean;
+/**
+ * Split a shell command into words, with the quoting rules of a POSIX shell:
+ * single quotes keep everything, double quotes and a backslash escape one character.
+ */
+export declare function splitCommand(command: string): string[];
+/**
+ * Quote a word for a POSIX shell when it needs quotes.
+ */
+export declare function quoteWord(word: string): string;
+/**
+ * Write a command in one canonical form, so that equivalent spellings compare equal:
+ * quotes only where needed, single spaces, and a relative `artisan` (or `./artisan`)
+ * replaced by its absolute path in `directory`.
+ *
+ * `php artisan queue:work 'database'  --queue="default"` in `/home/forge/example.com/`
+ * gives `php /home/forge/example.com/artisan queue:work database --queue=default`.
+ */
+export declare function canonicalCommand(command: string, directory: string | null): string;
+/**
+ * The site whose root holds `path`: the most specific root wins, so a site in
+ * `/home/forge/a.com/admin` is not owned by `/home/forge/a.com`. Returns null when no site holds it.
+ */
+export declare function siteOfPath(path: string, sites: SiteRoots[]): number | null;
+/**
+ * The sites whose roots a command uses as a path.
+ */
+export declare function sitesOfCommand(command: string, sites: SiteRoots[]): number[];
+/**
+ * Who owns a daemon or a scheduled job, from the point of view of one site:
+ * - `site`: it belongs to the site; `apply` can match it, and delete it when it is not declared
+ * - `ambiguous`: it may belong to the site; `apply` can match it but never deletes it
+ * - `other`: it belongs to another site, to the server, or to nobody known; `apply` ignores it
+ */
+export type Ownership = "site" | "ambiguous" | "other";
+/**
+ * Ownership of a daemon (a Forge background process).
+ *
+ * - With a directory: the site that holds the directory (see {@link siteOfPath}).
+ * - Without a directory: `ambiguous` when the command uses the site root, `site` only when
+ *   the command uses no other site root and Forge also associates the daemon with the site.
+ */
+export declare function daemonOwnership(daemon: {
+    directory: string | null;
+    command: string;
+}, siteId: number, sites: SiteRoots[], associatedWithSite: boolean): Ownership;
+/**
+ * Ownership of a scheduled job. Forge lists the jobs of a site on a site route: those
+ * belong to the site. A job of the server belongs to the site when its command uses the
+ * site root and no other site root; when it uses several site roots, it is `ambiguous`.
+ */
+export declare function scheduledJobOwnership(job: {
+    command: string;
+}, siteId: number, sites: SiteRoots[], listedOnSite: boolean): Ownership;
+//# sourceMappingURL=ownership.d.ts.map

package/dist/commands/sites/apply/ownership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownership.d.ts","sourceRoot":"","sources":["../../../../src/commands/sites/apply/ownership.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,gDAAgD;AAChD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,8EAA8E;IAC9E,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAKhE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9D;AAMD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAOtE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAsCtD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAUlF;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,GAAG,IAAI,CAW1E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,CAI5E;AAED;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC;AAEvD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE;IAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EACrD,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,SAAS,EAAE,EAClB,kBAAkB,EAAE,OAAO,GAC1B,SAAS,CAQX;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,EACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,SAAS,EAAE,EAClB,YAAY,EAAE,OAAO,GACpB,SAAS,CAKX"}

package/dist/commands/sites/apply/plan.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Compare a site file with the state of Forge and list the changes that `apply` makes.
+ * Pure functions: no API call here.
+ */
+import type { BackgroundProcessAttributes, DatabaseAttributes, DatabaseUserAttributes, ScheduledJobAttributes, SiteAttributes } from "@studiometa/forge-api";
+import type { SiteFile } from "./site-file.ts";
+import { type SiteRoots } from "./ownership.ts";
+export type Site = SiteAttributes & {
+    id: number;
+};
+export type Daemon = BackgroundProcessAttributes & {
+    id: number;
+};
+export type ScheduledJob = ScheduledJobAttributes & {
+    id: number;
+};
+export type Database = DatabaseAttributes & {
+    id: number;
+};
+export type DatabaseUser = DatabaseUserAttributes & {
+    id: number;
+};
+/** Shown in place of a generated password. */
+export declare const GENERATED = "<generated>";
+/** What `apply` reads from Forge. A list is undefined when the site file does not manage it. */
+export interface RemoteState {
+    /** All sites of the server. */
+    sites: Site[];
+    /** The site of the file, or null when it does not exist yet. */
+    site: Site | null;
+    databases?: Database[];
+    databaseUsers?: DatabaseUser[];
+    /** Content of the site .env; null when the site does not exist. */
+    env?: string | null;
+    /** All daemons of the server. */
+    daemons?: Daemon[];
+    /** IDs of the daemons that Forge associates with the site. */
+    siteDaemonIds?: ReadonlySet<number>;
+    /** All scheduled jobs of the server, with the jobs of the site. */
+    jobs?: ScheduledJob[];
+    /** IDs of the scheduled jobs that Forge lists on the site. */
+    siteJobIds?: ReadonlySet<number>;
+    /** Nginx configuration on Forge and the Nginx file rendered for the site; null when the site does not exist. */
+    nginx?: {
+        remote: string;
+        rendered: string;
+    } | null;
+}
+export interface SiteSettings {
+    type?: string;
+    php_version?: string;
+    web_directory?: string;
+    source_control_provider?: string;
+    repository?: string;
+    branch?: string;
+}
+export type Change = {
+    action: "create-site";
+    name: string;
+    settings: SiteSettings;
+} | {
+    action: "update-site";
+    changes: Array<{
+        field: string;
+        from: string | null;
+        to: string;
+    }>;
+} | {
+    action: "add-alias";
+    name: string;
+} | {
+    action: "create-database";
+    name: string;
+} | {
+    action: "create-database-user";
+    name: string;
+    database: string;
+} | {
+    action: "add-env";
+    keys: string[];
+    /** Keys that get the database name, user and password of a new database user. */
+    generated: string[];
+    /** The generated key that holds the password; its value never shows. */
+    password?: string;
+} | {
+    action: "create-worker";
+    command: string;
+    directory: string;
+    processes: number;
+} | {
+    action: "delete-worker";
+    id: number;
+    command: string;
+    directory: string | null;
+    processes: number;
+} | {
+    action: "create-job";
+    command: string;
+    frequency: string;
+    cron?: string;
+}
+/** `diff` is null for a site that does not exist yet: the file is rendered once it exists. */
+ | {
+    action: "update-nginx";
+    diff: string | null;
+} | {
+    action: "delete-job";
+    id: number;
+    command: string;
+    frequency: string;
+    cron: string;
+    onSite: boolean;
+};
+export interface Plan {
+    changes: Change[];
+    /** Differences that `apply` does not change, e.g. a different .env value. */
+    warnings: string[];
+}
+/** The path of the site folder, e.g. `/home/forge/example.com`. */
+export declare function siteHome(site: Pick<Site, "user" | "name">): string;
+/** The directory that workers run in and relative `artisan` resolves against. */
+export declare function siteWorkDirectory(site: Pick<Site, "user" | "name" | "root_directory">): string;
+/** The paths that belong to each site, for ownership. */
+export declare function siteRoots(sites: Site[]): SiteRoots[];
+/** `PHP 8.3`, `php83` and `php8.3` all give `php83`. */
+export declare function normalizePhp(version: string | null | undefined): string | null;
+/** The .env keys of a new database user, from `database.env` or the Laravel names. */
+export declare function databaseEnvKeys(database: NonNullable<SiteFile["database"]>): {
+    name: string;
+    user: string;
+    password: string;
+};
+/**
+ * Compare the site file with the state of Forge. Keys that the file does not have are not
+ * compared. The plan creates and updates what differs, and deletes only the workers and
+ * scheduled jobs that surely belong to the site and that the file does not declare.
+ */
+export declare function buildPlan(file: SiteFile, state: RemoteState): Plan;
+/**
+ * One line per change, for human output. Values of .env keys never show.
+ */
+export declare function describeChange(change: Change): string;
+/**
+ * The plan as text: one line per change, then the warnings.
+ */
+export declare function formatPlan(plan: Plan): string;
+//# sourceMappingURL=plan.d.ts.map

package/dist/commands/sites/apply/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../../src/commands/sites/apply/plan.ts"],"names":[],"mappings":"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"}

package/dist/commands/sites/apply/site-file.d.ts

@@ -0,0 +1,94 @@
+/**
+ * The site file of `forge sites apply`: a JSON file that declares one Forge site.
+ * A key that is absent is not managed; only `server` and `domain` are required.
+ */
+import * as v from "valibot";
+/** URL of the JSON Schema of the site file, published with the package. */
+export declare const SITE_FILE_SCHEMA_URL = "https://unpkg.com/@studiometa/forge-cli/schemas/site.schema.json";
+export declare const SITE_TYPES: readonly ["laravel", "symfony", "statamic", "wordpress", "phpmyadmin", "php", "nextjs", "nuxtjs", "static-html", "other", "custom"];
+export declare const SOURCE_CONTROL_PROVIDERS: readonly ["github", "gitlab", "bitbucket", "gitlab-custom", "custom"];
+export declare const SCHEDULE_FREQUENCIES: readonly ["minutely", "hourly", "nightly", "weekly", "monthly", "reboot", "custom"];
+export declare const WorkerSchema: v.StrictObjectSchema<{
+    readonly command: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>;
+    readonly processes: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, 1>;
+    readonly directory: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>, undefined>;
+}, undefined>;
+export declare const ScheduledJobSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
+    readonly command: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>;
+    readonly frequency: v.PicklistSchema<readonly ["minutely", "hourly", "nightly", "weekly", "monthly", "reboot", "custom"], undefined>;
+    readonly cron: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>, undefined>;
+}, undefined>, v.CheckAction<{
+    command: string;
+    frequency: "custom" | "hourly" | "minutely" | "monthly" | "nightly" | "reboot" | "weekly";
+    cron?: string | undefined;
+}, "cron is required with the custom frequency, and only with it">]>;
+/** The .env keys that a new database user gets. Default: the Laravel names. */
+export declare const DatabaseEnvSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
+    readonly name: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "invalid .env variable name">]>, undefined>;
+    readonly user: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "invalid .env variable name">]>, undefined>;
+    readonly password: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "invalid .env variable name">]>, undefined>;
+}, undefined>, v.CheckAction<{
+    name?: string | undefined;
+    user?: string | undefined;
+    password?: string | undefined;
+}, "the .env keys of the database must be different">]>;
+export declare const SiteFileSchema: v.StrictObjectSchema<{
+    readonly $schema: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly server: v.UnionSchema<[v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>, v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>], undefined>;
+    readonly domain: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>;
+    readonly aliases: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>, undefined>, undefined>;
+    readonly type: v.OptionalSchema<v.PicklistSchema<readonly ["laravel", "symfony", "statamic", "wordpress", "phpmyadmin", "php", "nextjs", "nuxtjs", "static-html", "other", "custom"], undefined>, undefined>;
+    readonly php: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "php must look like php83">]>, undefined>;
+    readonly webDirectory: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>, undefined>;
+    readonly repository: v.OptionalSchema<v.StrictObjectSchema<{
+        readonly provider: v.PicklistSchema<readonly ["github", "gitlab", "bitbucket", "gitlab-custom", "custom"], undefined>;
+        readonly url: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>;
+        readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>, undefined>;
+    }, undefined>, undefined>;
+    readonly database: v.OptionalSchema<v.StrictObjectSchema<{
+        readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>;
+        readonly user: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>;
+        readonly env: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
+            readonly name: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "invalid .env variable name">]>, undefined>;
+            readonly user: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "invalid .env variable name">]>, undefined>;
+            readonly password: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "invalid .env variable name">]>, undefined>;
+        }, undefined>, v.CheckAction<{
+            name?: string | undefined;
+            user?: string | undefined;
+            password?: string | undefined;
+        }, "the .env keys of the database must be different">]>, undefined>;
+    }, undefined>, undefined>;
+    readonly env: v.OptionalSchema<v.RecordSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "invalid .env variable name">]>, v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>, v.BooleanSchema<undefined>], undefined>, undefined>, undefined>;
+    readonly nginx: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>, undefined>;
+    readonly workers: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+        readonly command: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>;
+        readonly processes: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, 1>;
+        readonly directory: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>, undefined>;
+    }, undefined>, undefined>, undefined>;
+    readonly schedule: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
+        readonly command: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>;
+        readonly frequency: v.PicklistSchema<readonly ["minutely", "hourly", "nightly", "weekly", "monthly", "reboot", "custom"], undefined>;
+        readonly cron: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.NonEmptyAction<string, undefined>]>, undefined>;
+    }, undefined>, v.CheckAction<{
+        command: string;
+        frequency: "custom" | "hourly" | "minutely" | "monthly" | "nightly" | "reboot" | "weekly";
+        cron?: string | undefined;
+    }, "cron is required with the custom frequency, and only with it">]>, undefined>, undefined>;
+}, undefined>;
+export type SiteFileData = v.InferOutput<typeof SiteFileSchema>;
+/** A site file with the content of its Nginx file, when it declares one. */
+export type SiteFile = SiteFileData & {
+    nginxTemplate?: string;
+};
+export type WorkerDeclaration = v.InferOutput<typeof WorkerSchema>;
+export type ScheduledJobDeclaration = v.InferOutput<typeof ScheduledJobSchema>;
+/**
+ * Validate parsed JSON as a site file. Throws a ValidationError that lists every issue.
+ */
+export declare function parseSiteFile(data: unknown, source?: string): SiteFileData;
+/**
+ * Read and validate a site file from disk, with its Nginx file: a relative `nginx` path is
+ * read against the folder of the site file.
+ */
+export declare function readSiteFile(path: string): SiteFile;
+//# sourceMappingURL=site-file.d.ts.map

package/dist/commands/sites/apply/site-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-file.d.ts","sourceRoot":"","sources":["../../../../src/commands/sites/apply/site-file.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAK7B,2EAA2E;AAC3E,eAAO,MAAM,oBAAoB,qEACmC,CAAC;AAIrE,eAAO,MAAM,UAAU,YACrB,SAAS,EACT,SAAS,EACT,UAAU,EACV,WAAW,EACX,YAAY,EACZ,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,OAAO,EACP,QAAQ,CACA,CAAC;AAEX,eAAO,MAAM,wBAAwB,YACnC,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,eAAe,EACf,QAAQ,CACA,CAAC;AAEX,eAAO,MAAM,oBAAoB,YAC/B,UAAU,EACV,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,QAAQ,CACA,CAAC;AAEX,eAAO,MAAM,YAAY;;;;aAIvB,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;oEAU9B,CAAC;AAOF,+EAA+E;AAC/E,eAAO,MAAM,iBAAiB;;;;;;;;uDAY7B,CAAC;AAEF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAsBzB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,cAAc,CAAC,CAAC;AAEhE,4EAA4E;AAC5E,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACjE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,YAAY,CAAC,CAAC;AACnE,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE/E;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,SAAc,GAAG,YAAY,CAU/E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CA6BnD"}

package/dist/commands/sites/apply/test-fixtures.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Fixtures of Forge resources for the tests of `forge sites apply`.
+ */
+import type { CliExecutorContext } from "../../../context.ts";
+import type { Daemon, ScheduledJob, Site } from "./plan.ts";
+export declare function site(id: number, name: string, overrides?: Partial<Site>): Site;
+export declare function daemon(id: number, command: string, directory: string | null, overrides?: Partial<Daemon>): Daemon;
+export declare function job(id: number, command: string, overrides?: Partial<ScheduledJob>): ScheduledJob;
+type Call = [method: string, url: string, body?: unknown];
+/** Attributes of server 123, for the `SERVER_*` Nginx variables. */
+export declare function webServer(): {
+    id: number;
+    credential_id: null;
+    name: string;
+    type: string;
+    ubuntu_version: string;
+    ssh_port: number;
+    provider: string;
+    identifier: null;
+    size: string;
+    region: string;
+    php_version: null;
+    php_cli_version: null;
+    opcache_status: null;
+    database_type: null;
+    db_status: null;
+    redis_status: null;
+    revoked: boolean;
+    created_at: string;
+    updated_at: string;
+    connection_status: null;
+    timezone: string;
+    local_public_key: null;
+    is_ready: boolean;
+    ip_address: string;
+    private_ip_address: string;
+};
+export interface FakeForge {
+    sites: Site[];
+    daemons: Daemon[];
+    siteDaemonIds: number[];
+    jobs: ScheduledJob[];
+    siteJobIds: number[];
+    databases: Array<{
+        id: number;
+        name: string;
+    }>;
+    users: Array<{
+        id: number;
+        name: string;
+    }>;
+    env: string;
+    /** Nginx configuration of every site. */
+    nginx: string;
+    /** Statuses a new site goes through, one per read. */
+    newSiteStatuses: string[];
+}
+/**
+ * A fake Forge API client, enough for `apply`. It records every call.
+ */
+export declare function fakeForge(initial?: Partial<FakeForge>): {
+    ctx: CliExecutorContext;
+    calls: Call[];
+    state: FakeForge;
+    client: {
+        get: import("vitest").Mock<(url: string) => Promise<{
+            data: {
+                id: string;
+                type: string;
+                attributes: {};
+            }[];
+            links: {};
+            meta: {
+                per_page: number;
+                next_cursor: null;
+                prev_cursor: null;
+            };
+        } | {
+            data: {
+                id: string;
+                type: string;
+                attributes: {};
+            };
+        }>>;
+        post: import("vitest").Mock<(raw: string, body: Record<string, unknown>) => Promise<{
+            data: {
+                id: string;
+                type: string;
+                attributes: {};
+            };
+        }>>;
+        put: import("vitest").Mock<(raw: string, body: Record<string, unknown>) => Promise<{
+            data: {
+                id: string;
+                type: string;
+                attributes: {};
+            };
+        } | null>>;
+        delete: import("vitest").Mock<(url: string) => Promise<void>>;
+        patch: import("vitest").Mock<import("@vitest/spy").Procedure>;
+    };
+};
+export {};
+//# sourceMappingURL=test-fixtures.d.ts.map

package/dist/commands/sites/apply/test-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-fixtures.d.ts","sourceRoot":"","sources":["../../../../src/commands/sites/apply/test-fixtures.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE5D,wBAAgB,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,OAAO,CAAC,IAAI,CAAM,GAAG,IAAI,CAmClF;AAED,wBAAgB,MAAM,CACpB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,SAAS,GAAE,OAAO,CAAC,MAAM,CAAM,GAC9B,MAAM,CAWR;AAED,wBAAgB,GAAG,CACjB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,OAAO,CAAC,YAAY,CAAM,GACpC,YAAY,CAcd;AAED,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;AAiD1D,oEAAoE;AACpE,wBAAgB,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;EAExB;AAOD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,OAAO,CAAC,SAAS,CAAM;;;;;yCAkB/B,MAAM;;;;;;;;gBApFrB,QAAQ;gBAAM,WAAW;gBAAQ,WAAW;;;;;;;;;0CA4I5B,MAAM,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;yCAsCtC,MAAM,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;4CAalC,MAAM;;;EAYnC"}

package/dist/commands/sites/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/commands/sites/command.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,kBAAkB,6GAQ7B,CAAC"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/commands/sites/command.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,kBAAkB,6GAU7B,CAAC"}

package/dist/commands/sites/help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/commands/sites/help.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAqDvD"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/commands/sites/help.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CA8FvD"}

package/dist/commands/ssh-keys/sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/commands/ssh-keys/sync.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AA8KvD;;GAEG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAgHpE"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/commands/ssh-keys/sync.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAsB,cAAc,EAAE,MAAM,kBAAkB,CAAC;AA8K3E;;GAEG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAgHpE"}