@studiometa/trafic-agent 0.1.49 → 0.1.51

package/dist/tasks/destroy-scheduled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"destroy-scheduled.d.ts","sourceRoot":"","sources":["../../src/tasks/destroy-scheduled.ts"],"names":[],"mappings":"AACA,OAAO,EAML,KAAK,KAAK,EACX,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,EACtD,GAAG,GAAE,KAAmB,GACvB,IAAI,CAkBN;AAKD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,WAAW,EACnB,GAAG,GAAE,KAAmB,EACxB,GAAG,GAAE,UAA2B,GAC/B,OAAO,CAAC,IAAI,CAAC,CAyCf;AAOD;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC,OAAO,CAYlF"}

package/dist/tasks/running-limit.d.ts

@@ -0,0 +1,54 @@
+import { getProject } from "../utils/db.js";
+import { type DdevRunner } from "../utils/ddev.js";
+import type { DdevProject } from "../types.js";
+/**
+ * What the limit needs from the outside world. Injected so a test can set
+ * the DDEV state and record the stops without a DDEV install.
+ */
+export interface RunningLimitDeps {
+    listProjects: () => Promise<DdevProject[]>;
+    stopProject: (name: string) => Promise<boolean>;
+    getProject: typeof getProject;
+    setProjectStatus: (name: string, status: "running" | "stopped") => void;
+    updateProjectAccess: (name: string) => void;
+}
+/**
+ * The real dependencies: the agent database, and DDEV through `run`. The
+ * default runner is the real one.
+ */
+export declare function ddevRunningLimitDeps(run?: DdevRunner): RunningLimitDeps;
+export interface RunningLimitOptions {
+    /** max_running_projects: 0 means no limit */
+    max: number;
+    /** Whether a project's own config says never to stop it */
+    neverStops: (name: string) => boolean;
+}
+/**
+ * Stop the least recently used projects until `max` or fewer run.
+ *
+ * A project runs when `ddev list` shows it up, or when the agent is starting
+ * it (status "starting" in the database). `ddev list` is the source because
+ * `trafic deploy` runs `ddev start` itself, so the database does not know
+ * about every running project. The projects the agent is starting count too,
+ * because DDEV shows them stopped until their containers exist: the waiting
+ * page marks its project "starting" before it calls this, so that project
+ * counts once whether DDEV shows it up or not, and calls made for starts at
+ * the same time each see all of them.
+ *
+ * Because of deploys, the database is first brought in line with DDEV. A
+ * project that runs while the database says it is stopped (or has no record
+ * of it) was started outside the agent, most likely by a deploy. Its last
+ * access is then old or missing, which would make it the first one stopped,
+ * right after the deploy. It is recorded as accessed now instead. A project
+ * the database says runs while DDEV says it does not was stopped outside the
+ * agent, and is recorded as stopped, so its next start is seen too.
+ *
+ * Projects with `idle_timeout: never`, projects the agent is starting and
+ * projects `trafic-agent destroy` is removing (status "destroying": its
+ * backup starts a stopped project) are never stopped. When no other project
+ * can be stopped, a warning is logged and the server stays over the limit.
+ *
+ * Returns the names of the projects it stopped.
+ */
+export declare function enforceRunningLimit(options: RunningLimitOptions, deps?: RunningLimitDeps): Promise<string[]>;
+//# sourceMappingURL=running-limit.d.ts.map

package/dist/tasks/running-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"running-limit.d.ts","sourceRoot":"","sources":["../../src/tasks/running-limit.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAGX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,aAAa,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC3C,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,SAAS,KAAK,IAAI,CAAC;IACxE,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,GAAE,UAA2B,GAC/B,gBAAgB,CAQlB;AAOD,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACvC;AAWD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,mBAAmB,EAC5B,IAAI,GAAE,gBAAyC,GAC9C,OAAO,CAAC,MAAM,EAAE,CAAC,CA2DnB"}

package/dist/tasks/stop-idle.d.ts

@@ -1,8 +1,19 @@
+import { type DdevRunner } from "../utils/ddev.js";
 import type { AgentConfig } from "../types.js";
 /**
  * Stop idle projects that haven't been accessed recently
- * Respects per-project idle_timeout settings from .ddev/config.trafic.yaml
+ * A project's idle_timeout in .ddev/config.trafic.yaml replaces the global
+ * one, shorter or longer
+ *
+ * Only projects with the status "running" are idle: a project the agent is
+ * starting or removing is never stopped here. A start or a removal whose
+ * process was killed is set back to "running" first, so its project is not
+ * left up for good. Before that, the records of projects that DDEV no longer
+ * lists are deleted, so the sweep does not ask DDEV about them.
+ *
+ * Then brings the server back under max_running_projects: a deploy runs
+ * `ddev start` without asking the agent, so only the sweep sees it.
  */
-export declare function stopIdleProjects(config: AgentConfig): Promise<void>;
+export declare function stopIdleProjects(config: AgentConfig, run?: DdevRunner): Promise<void>;
 export declare function startIdleScheduler(config: AgentConfig): NodeJS.Timeout;
 //# sourceMappingURL=stop-idle.d.ts.map

package/dist/tasks/stop-idle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stop-idle.d.ts","sourceRoot":"","sources":["../../src/tasks/stop-idle.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAkDzE;AAUD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC,OAAO,CActE"}
+{"version":3,"file":"stop-idle.d.ts","sourceRoot":"","sources":["../../src/tasks/stop-idle.ts"],"names":[],"mappings":"AAMA,OAAO,EAKL,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAC;AAI1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,WAAW,EACnB,GAAG,GAAE,UAA2B,GAC/B,OAAO,CAAC,IAAI,CAAC,CA4Df;AAUD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC,OAAO,CActE"}

package/dist/types.d.ts

@@ -16,10 +16,26 @@ export interface AgentConfig {
     idleTimeout: string;
     /** Interval for checking idle projects (e.g., "5m") */
     idleCheckInterval: string;
+    /** Most projects running at the same time (0 = no limit) */
+    maxRunningProjects: number;
     /** Auth configuration */
     auth: AuthConfig;
     /** TLS configuration */
     tls: TlsConfig;
+    /** Backup configuration */
+    backup: BackupConfig;
+}
+/**
+ * Backup configuration.
+ *
+ * A backup is a directory `<dir>/<project>/<timestamp>` that holds the
+ * database dump and an archive of the upload directories.
+ */
+export interface BackupConfig {
+    /** Directory that holds the backups */
+    dir: string;
+    /** Days to keep a backup before the agent removes it */
+    retainDays: number;
 }
 /**
  * TLS configuration.
@@ -85,12 +101,13 @@ export interface AuthRule {
  */
 export interface DdevProject {
     name: string;
-    status: "running" | "stopped" | "paused" | "unhealthy";
+    status: "running" | "starting" | "stopped" | "paused" | "unhealthy";
     appRoot: string;
     httpURLs: string[];
     httpsURLs: string[];
     type: string;
     phpVersion?: string;
+    /** Database type, or undefined when the project omits the db container */
     dbType?: string;
 }
 /**
@@ -99,7 +116,29 @@ export interface DdevProject {
 export interface ProjectRecord {
     name: string;
     lastAccess: number;
-    status: "running" | "stopped" | "starting";
+    /**
+     * "starting": the waiting page is starting it. "destroying": trafic-agent
+     * destroy is removing it, see destroyProject. Both are set back when their
+     * process is gone, see releaseStaleStatuses.
+     */
+    status: "running" | "stopped" | "starting" | "destroying";
+}
+/**
+ * A removal scheduled with `trafic-agent destroy --delay`
+ */
+export interface ScheduledDestroy {
+    name: string;
+    /** When the removal is due, as a Unix timestamp in milliseconds */
+    destroyAt: number;
+    /** Whether to back the project up before it is removed */
+    backup: boolean;
+    /** Time limit of the backup (`--timeout`), when one was given */
+    timeoutMs?: number;
+    /**
+     * Whether the sweep has started to remove the project, after its backup:
+     * a cancel is then too late, and a retry does not back it up again
+     */
+    removing: boolean;
 }
 /**
  * Access log entry

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,yBAAyB;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,wBAAwB;IACxB,GAAG,EAAE,SAAS,CAAC;IACf,2BAA2B;IAC3B,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,2DAA2D;IAC3D,aAAa,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACpD,kDAAkD;IAClD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,iDAAiD;IACjD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,yBAAyB;IACzB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB;;;;;;;;;;OAUG;IACH,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IAC7C,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,CAAC;CAC3D;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,MAAM,EAAE,OAAO,CAAC;IAChB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/utils/config.d.ts

@@ -3,6 +3,12 @@ import type { AgentConfig } from "../types.js";
  * Parse a duration string (e.g., "30m", "1h", "2h30m") to milliseconds
  */
 export declare function parseDuration(duration: string): number;
+/**
+ * Parse a command-line timeout such as "10m", "90s" or "1h"; a bare number
+ * is minutes. The grammar is the one of `trafic --timeout`, which the CLI
+ * passes on as is. Returns undefined for anything else, or for zero.
+ */
+export declare function parseTimeout(value: string): number | undefined;
 /**
  * Load configuration from TOML file
  */

package/dist/utils/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAmC,MAAM,aAAa,CAAC;AA6BhF;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUtD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,CAkC3D;AAqFD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,CA+B5D"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAiD,MAAM,aAAa,CAAC;AAmC9F;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUtD;AAKD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQ9D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,CAuC3D;AAkGD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,CAwD5D"}

package/dist/utils/db.d.ts

@@ -1,5 +1,5 @@
 import { DatabaseSync } from "node:sqlite";
-import type { ProjectRecord, AccessLog } from "../types.js";
+import type { ProjectRecord, AccessLog, ScheduledDestroy } from "../types.js";
 /**
  * Reads the current time in epoch milliseconds.
  *
@@ -31,12 +31,87 @@ export declare function updateProjectAccess(name: string, now?: Clock): void;
 export declare function getProject(name: string): ProjectRecord | undefined;
 /**
  * Set project status
+ *
+ * A busy status ("starting", "destroying") records the id of this process,
+ * so releaseStaleStatuses can tell when the process that set it is gone.
  */
 export declare function setProjectStatus(name: string, status: ProjectRecord["status"], now?: Clock): void;
+/**
+ * Whether a process is alive. EPERM means it is, but belongs to another user.
+ */
+export declare function isProcessAlive(pid: number): boolean;
+/**
+ * Set back to "running" the busy statuses ("starting", "destroying") whose
+ * process is gone, and return the names of those projects.
+ *
+ * The process that sets a busy status sets it back when it ends. A process
+ * that is killed (a cancelled CI job, a dropped SSH connection, a restart of
+ * the service) cannot, and the status would stay: the sweeps never stop a
+ * busy project, max_running_projects counts it as running, and the waiting
+ * page never starts it. "running" lets the idle sweep check the project
+ * against DDEV and stop it, also when it is stopped already.
+ *
+ * `isAlive` says whether a process still works on its project: the service
+ * passes its own check at start, where its own id is not alive yet.
+ */
+export declare function releaseStaleStatuses(isAlive?: (pid: number) => boolean): string[];
 /**
  * Get idle projects (last access older than threshold)
  */
 export declare function getIdleProjects(thresholdMs: number, now?: Clock): ProjectRecord[];
+/**
+ * Delete every record of a project: its status row, its access logs and its
+ * scheduled removal. Returns whether there was any.
+ */
+export declare function deleteProject(name: string): boolean;
+/**
+ * Delete the records of the projects that DDEV no longer lists, and return
+ * their names.
+ *
+ * A project removed outside the agent (`ddev delete` by hand, or a
+ * `trafic destroy` older than the agent's own removal) leaves its row behind.
+ * releaseStaleStatuses would set that row back to "running", and every sweep
+ * would then ask DDEV about a project it does not know.
+ *
+ * A project with a busy status whose process lives is kept: `ddev delete`
+ * takes it out of the list before its removal deletes the records. A project
+ * with a scheduled removal is kept too: `ddev delete` by hand leaves its
+ * directory, and the scheduled removal still has to remove it. An empty
+ * list is kept as is too: a missing or unreadable project list is more likely
+ * than a server with no project, and keeping the rows is harmless.
+ */
+export declare function deleteUnlistedProjects(listed: ReadonlySet<string>, isAlive?: (pid: number) => boolean): string[];
+/**
+ * Schedule the removal of a project, or replace a removal already
+ * scheduled. `timeoutMs` is the time limit of the backup.
+ */
+export declare function scheduleDestroy(name: string, destroyAt: number, backup: boolean, timeoutMs?: number): void;
+/**
+ * Cancel the scheduled removal of a project:
+ * - "cancelled" when it was scheduled and is now cancelled
+ * - "none" when there was none
+ * - "removing" when the sweep already removes the project (see
+ *   startScheduledDestroy): it is too late, and the removal stays
+ */
+export declare function cancelScheduledDestroy(name: string): "cancelled" | "none" | "removing";
+/**
+ * Mark a scheduled removal as started, when it is still due at `dueBy`.
+ * From then on, a cancel is refused, and a retry after a failure does not
+ * back the project up again. Returns false when the removal was cancelled
+ * or moved to a later date meanwhile. One statement, so a cancel from
+ * another process comes either before (false) or after (refused).
+ */
+export declare function startScheduledDestroy(name: string, dueBy: number): boolean;
+/**
+ * Get the scheduled removals, soonest first. With `dueBy`, only the removals
+ * due at or before that time.
+ */
+export declare function getScheduledDestroys(dueBy?: number): ScheduledDestroy[];
+/**
+ * Get the scheduled removal of a project when it is due at or before
+ * `dueBy`, or undefined when there is none.
+ */
+export declare function getScheduledDestroy(name: string, dueBy?: number): ScheduledDestroy | undefined;
 /**
  * Log an access
  */

package/dist/utils/db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/utils/db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC;AAEjC,2DAA2D;AAC3D,eAAO,MAAM,WAAW,EAAE,KAAwB,CAAC;AAInD;;GAEG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CA0BnD;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,YAAY,CAKpC;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAK9B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,KAAmB,GAAG,IAAI,CAQhF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAMlE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,EAC/B,GAAG,GAAE,KAAmB,GACvB,IAAI,CAQN;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,GAAG,GAAE,KAAmB,GACvB,aAAa,EAAE,CASjB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,IAAI,CAO1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,SAAS,EAAE,CAUvE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,KAAmB,GAAG,MAAM,CAM3E"}
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/utils/db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE9E;;;;;GAKG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC;AAEjC,2DAA2D;AAC3D,eAAO,MAAM,WAAW,EAAE,KAAwB,CAAC;AAanD;;GAEG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAsCnD;AAiBD;;GAEG;AACH,wBAAgB,KAAK,IAAI,YAAY,CAKpC;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAK9B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,KAAmB,GAAG,IAAI,CAQhF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAMlE;AAQD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,EAC/B,GAAG,GAAE,KAAmB,GACvB,IAAI,CAUN;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOnD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAwB,GACjD,MAAM,EAAE,CA0BV;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,GAAG,GAAE,KAAmB,GACvB,aAAa,EAAE,CASjB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQnD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,EAC3B,OAAO,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAwB,GACjD,MAAM,EAAE,CA0BV;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,EACf,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAWN;AA+BD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,UAAU,CAWtF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAM1E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,SAA0B,GAAG,gBAAgB,EAAE,CAUxF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,KAAK,SAA0B,GAC9B,gBAAgB,GAAG,SAAS,CAS9B;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,IAAI,CAO1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,SAAS,EAAE,CAUvE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,KAAmB,GAAG,MAAM,CAM3E"}

package/dist/utils/ddev.d.ts

@@ -5,8 +5,8 @@ import type { DdevProject } from "../types.js";
  *
  * The file nests the path under the project name:
  *
- *   scalian:
- *       approot: /home/ddev/www/scalian
+ *   my-app:
+ *       approot: /home/ddev/www/my-app
  *
  * Indentation therefore has to be read. A flat key/value pass produces one
  * entry per line instead: the project mapped to an empty string, plus a
@@ -47,8 +47,11 @@ export interface DdevResult {
 /**
  * Runs a ddev command. Injected so tests drive the outcome directly instead
  * of replacing node:child_process for the whole module.
+ *
+ * `cwd` is for the commands that act on the project in that directory rather
+ * than on a project named in `args`.
  */
-export type DdevRunner = (args: string[], timeoutMs: number) => Promise<DdevResult>;
+export type DdevRunner = (args: string[], timeoutMs: number, cwd?: string) => Promise<DdevResult>;
 /** The real runner, used unless a caller passes its own. */
 export declare const nodeDdevRunner: DdevRunner;
 /**
@@ -67,7 +70,11 @@ export declare function startProject(name: string, run?: DdevRunner): Promise<bo
  */
 export declare function stopProject(name: string, run?: DdevRunner): Promise<boolean>;
 /**
- * List all DDEV projects with their status
+ * List all DDEV projects with their live status.
+ *
+ * `ddev list -j` asks Docker, so a project started or stopped outside the
+ * agent (by `trafic deploy`, say) shows its real state here. It wraps the
+ * entries in a `raw` array.
  */
-export declare function listProjects(): DdevProject[];
+export declare function listProjects(run?: DdevRunner): Promise<DdevProject[]>;
 //# sourceMappingURL=ddev.d.ts.map

package/dist/utils/ddev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ddev.d.ts","sourceRoot":"","sources":["../../src/utils/ddev.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAoB/C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAC7B,eAAe,EAAE,MAAM,GACtB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA+BrB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,GAAG,EAAE,MAAM,GACV,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CASrB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACzB,MAAM,GAAG,SAAS,CAEpB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,IAAI,GACnB,IAAI,CAWN;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,CACvB,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,UAAU,CAAC,CAAC;AAEzB,4DAA4D;AAC5D,eAAO,MAAM,cAAc,EAAE,UAgBzB,CAAC;AAEL;;GAEG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,UAA2B,GAC/B,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CA0BlC;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,UAA2B,GAC/B,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,UAA2B,GAC/B,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,WAAW,EAAE,CAqB5C"}
+{"version":3,"file":"ddev.d.ts","sourceRoot":"","sources":["../../src/utils/ddev.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAoB/C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAC7B,eAAe,EAAE,MAAM,GACtB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA+BrB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,GAAG,EAAE,MAAM,GACV,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CASrB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACzB,MAAM,GAAG,SAAS,CAEpB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,IAAI,GACnB,IAAI,CAWN;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,CACvB,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,EAAE,MAAM,EACjB,GAAG,CAAC,EAAE,MAAM,KACT,OAAO,CAAC,UAAU,CAAC,CAAC;AAEzB,4DAA4D;AAC5D,eAAO,MAAM,cAAc,EAAE,UAgBzB,CAAC;AAEL;;GAEG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,UAA2B,GAC/B,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CA2BlC;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,UAA2B,GAC/B,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,UAA2B,GAC/B,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,GAAG,GAAE,UAA2B,GAC/B,OAAO,CAAC,WAAW,EAAE,CAAC,CAuBxB"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,3 @@
+/** Whether `child` is strictly inside `parent`. Both are resolved paths. */
+export declare function isInside(parent: string, child: string): boolean;
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAG/D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@studiometa/trafic-agent",
-  "version": "0.1.49",
+  "version": "0.1.51",
   "description": "Server agent for DDEV preview environments — auth, scale-to-zero, auto-start",
   "keywords": [
     "agent",