@homeflare/alchemy 0.31.2 → 0.33.0

package/dist/linux/container.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `Podman.Container` — one Quadlet `.container` file, declared, plus the systemd unit Podman's own
+ * generator turns it into.
+ *
+ * - create / update — render, write the `.container` file atomically, `daemon-reload`, VERIFY the
+ *   generator actually produced `<name>.service` (container-generator.ts), then start or RESTART
+ *   the generated unit only when something changed (container-lifecycle.ts, container-settle.ts).
+ * - read — the `.container` file's SHA-256 plus `systemctl show <name>.service`.
+ * - diff — the rendered digest against stored and on-disk, running state against the declaration,
+ *   and systemd's own `NeedDaemonReload`.
+ * - replace — only when the file's name or directory changes, delete-first.
+ * - delete — stop the generated unit, remove the `.container` file, reload.
+ *
+ * ⛔ A DEPLOY NEVER MASS-RESTARTS — see container-lifecycle.ts's header.
+ * ⛔ THE `.container` FILE IS NEVER A SECRET, and `[Container] Environment=` is refused if it looks
+ *   like one — see container-form.ts and container-secrets.ts.
+ * ⛔ THE GENERATED UNIT IS NEVER `systemctl enable`D — see container-generator.ts's header for why,
+ *   measured and doc-cited, and what stands in for it (`install.wantedBy`).
+ * ⚠️ NOTHING IS ADOPTED WITHOUT `--adopt` — same contract as every family here.
+ */
+import { Resource } from 'alchemy';
+import * as Provider from 'alchemy/Provider';
+import { HostRunnerService } from '../launchd/runner.ts';
+import type { ContainerAttributes, ContainerProps } from './container-form.ts';
+export type { ContainerAttributes as PodmanContainerAttributes, ContainerProps as PodmanContainerProps, ContainerSection, UnitLine as PodmanUnitLine, } from './container-form.ts';
+export interface PodmanContainer extends Resource<'Podman.Container', ContainerProps, ContainerAttributes> {
+}
+export declare const PodmanContainer: import("alchemy").ResourceClass<PodmanContainer>;
+export declare const PodmanContainerProvider: () => import("effect/Layer").Layer<Provider.Provider<PodmanContainer>, never, HostRunnerService>;
+//# sourceMappingURL=container.d.ts.map

package/dist/linux/container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../src/linux/container.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG/E,YAAY,EACV,mBAAmB,IAAI,yBAAyB,EAChD,cAAc,IAAI,oBAAoB,EACtC,gBAAgB,EAChB,QAAQ,IAAI,cAAc,GAC3B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,eAAgB,SAAQ,QAAQ,CAC/C,kBAAkB,EAClB,cAAc,EACd,mBAAmB,CACpB;CAAG;AAEJ,eAAO,MAAM,eAAe,kDAAgD,CAAC;AAE7E,eAAO,MAAM,uBAAuB,kGAiBjC,CAAC"}

package/dist/linux/fake-quadlet.d.ts

@@ -0,0 +1,25 @@
+import { type FakeLinuxOptions } from './fake-linux-host.ts';
+import type { HostRunner } from '../launchd/runner.ts';
+/** A line no real Quadlet key ever spells, so a test can force the (fake) generator to refuse a file. */
+export declare const FAIL_GENERATOR_MARKER = "X-Test-Fail-Generator=1";
+export declare const fakeQuadletHost: (options?: FakeLinuxOptions) => {
+    calls: string[][];
+    dirs: Map<string, number>;
+    expectUnit: (path: string) => void;
+    files: Map<string, {
+        bytes: Uint8Array;
+        mode: number;
+        uid: number;
+        gid: number;
+        kind: import("./index.ts").FileStat['kind'];
+    }>;
+    modes: Map<string, {
+        mode: number;
+        uid: number;
+        gid: number;
+    }>;
+    placeUnit: (path: string, text: string, state?: Partial<import("./fake-systemd.ts").UnitState>) => void;
+    units: Map<string, import("./fake-systemd.ts").UnitState>;
+    runner: HostRunner;
+};
+//# sourceMappingURL=fake-quadlet.d.ts.map

package/dist/linux/fake-quadlet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-quadlet.d.ts","sourceRoot":"","sources":["../../src/linux/fake-quadlet.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,KAAK,gBAAgB,EAAiB,MAAM,sBAAsB,CAAC;AAG5E,OAAO,KAAK,EAAc,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEnE,yGAAyG;AACzG,eAAO,MAAM,qBAAqB,4BAA4B,CAAC;AAO/D,eAAO,MAAM,eAAe,aAAa,gBAAgB;;;;;;;;;;;;;;;;;;;CAiGxD,CAAC"}

package/dist/linux/index.d.ts

@@ -1,13 +1,13 @@
 /**
  * Linux host providers for Alchemy — a host's directories, its files (whole, or one managed block
- * inside somebody else's file) and its systemd units, over the SAME HostRunner seam the launchd
- * subpath drives a Mac through.
+ * inside somebody else's file), its systemd units and its Podman Quadlet containers, over the SAME
+ * HostRunner seam the launchd subpath drives a Mac through.
  *
  * ⛔ THIS BARREL IS THE PUBLIC API, AND IT IS DELIBERATELY SMALLER THAN THE DIRECTORY. The lifecycle
  *   files, the systemctl parsers and the fake host are internals; an `export *` would publish them
  *   as API and make the next refactor a breaking change.
  * ⛔ A DEPLOY NEVER MASS-RESTARTS: a unit is restarted only when its own file changed, or a digest
- *   the declaration listed changed. See docs/linux-host.md.
+ *   the declaration listed changed. See docs/linux-host.md and docs/quadlet-container.md.
  * ★ THE SEAM IS SHARED, NOT COPIED. `HostRunner` is re-exported here so a Linux stack never has to
  *   import from the launchd subpath to type its own runner.
  */
@@ -26,4 +26,7 @@ export { HostRunnerService, canActAsRoot, hostRunnerLayer } from '../launchd/run
 export type { SystemdUnitAttributes, SystemdUnitProps, UnitSection } from './unit-form.ts';
 export { DEFAULT_UNIT_DIRECTORY, renderUnit } from './unit-form.ts';
 export { SystemdTimer, SystemdTimerProvider, SystemdUnit, SystemdUnitProvider } from './unit.ts';
+export type { ContainerSection, PodmanContainerAttributes, PodmanContainerProps, PodmanUnitLine, } from './container.ts';
+export { QUADLET_DEFAULT_DIRECTORY, QUADLET_SEARCH_DIRECTORIES } from './container-form.ts';
+export { PodmanContainer, PodmanContainerProvider } from './container.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/linux/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/linux/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,YAAY,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAClE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,YAAY,GACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACxF,YAAY,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/linux/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,YAAY,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAClE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,YAAY,GACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACxF,YAAY,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACjG,YAAY,EACV,gBAAgB,EAChB,yBAAyB,EACzB,oBAAoB,EACpB,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC"}