typekro 0.16.1 → 0.17.0

package/dist/factories/caddy/types.js

@@ -3,8 +3,10 @@
  *
  * Caddy here is a CONFIG-DRIVEN reverse proxy (not the Caddy ingress-controller, and not a Helm
  * bootstrap): the composition runs the official `caddy` image with a Caddyfile we supply, and emits a
- * ConfigMap (Caddyfile) + Deployment + Service + PVC. Caddy's built-in `tls internal` issues certs from a
- * local CA (no cert-manager), so the PVC persists `/data` (the CA root) across restarts.
+ * ConfigMap (Caddyfile) + Deployment + Service + a `/data` volume. Caddy's built-in `tls internal` issues
+ * certs from a local CA (no cert-manager). By default `/data` is a PVC so the CA root persists across
+ * restarts; `makeCaddyIngress({ ephemeral: true })` uses an `emptyDir` instead (CA regenerates per pod),
+ * and that variant takes no `persistence` config (see `CaddyIngressEphemeralConfigSchema`).
  *
  * KRO-safety note: the Caddyfile is supplied as a STRING (`caddyfile`), not derived from a structured
  * `routes` array inside the composition. A `routes` array would be a graph proxy in KRO mode and cannot be
@@ -18,9 +20,11 @@ const resourceRequirementsSchemaShape = {
     'limits?': { 'cpu?': 'string', 'memory?': 'string' },
 };
 /**
- * Sizing for the PVC backing Caddy's `/data` (the `tls internal` CA root + issued certs). The PVC is
- * always created — persisting the CA root is required so it's stable across restarts; an ephemeral/emptyDir
- * mode isn't offered because a conditional volume can't be expressed safely in KRO (compound includeWhen).
+ * Sizing for the PVC backing Caddy's `/data` (the `tls internal` CA root + issued certs), persisting the
+ * CA across restarts. An `emptyDir` alternative IS available, but as a BUILD-TIME option on the
+ * composition (`makeCaddyIngress({ ephemeral: true })`), not a spec field — the storage choice is made
+ * when the composition is constructed, so it selects the resource set statically and never needs a KRO
+ * runtime conditional. (A spec-field toggle would require an unsafe compound `includeWhen`.)
  */
 const persistenceSchemaShape = {
     'size?': 'string',
@@ -34,7 +38,7 @@ const persistenceSchemaShape = {
  * dropped — notably `replicaCount`: this composition is single-replica by design (the `tls internal` CA
  * lives in a RWO PVC one pod owns), so a replica knob would invite a broken multi-pod-shares-RWO setup.
  */
-export const CaddyIngressConfigSchema = type({
+const baseCaddyIngressShape = {
     '+': 'reject',
     name: 'string',
     'namespace?': 'string',
@@ -53,10 +57,20 @@ export const CaddyIngressConfigSchema = type({
     'httpsPort?': 'number',
     /** Service type (default ClusterIP — reached via the access tunnel; no public LB). */
     'serviceType?': '"ClusterIP" | "NodePort" | "LoadBalancer"',
-    /** Sizing for the always-created `/data` PVC that holds the `tls internal` CA root (default 1Gi). */
-    'persistence?': persistenceSchemaShape,
     'resources?': resourceRequirementsSchemaShape,
+};
+/** The default (PVC-backed) Caddy-ingress config. `persistence` sizes the `/data` PVC. */
+export const CaddyIngressConfigSchema = type({
+    ...baseCaddyIngressShape,
+    /** Sizing for the `/data` PVC that holds the `tls internal` CA root (default 1Gi). PVC mode only. */
+    'persistence?': persistenceSchemaShape,
 });
+/**
+ * The ephemeral (emptyDir) Caddy-ingress config — used by `makeCaddyIngress({ ephemeral: true })`. It has
+ * NO `persistence` field: there is no PVC to size, so a `persistence` value would be silently ignored.
+ * The inherited `'+': 'reject'` makes passing `persistence` (or any unknown key) fail loudly instead.
+ */
+export const CaddyIngressEphemeralConfigSchema = type({ ...baseCaddyIngressShape });
 /**
  * Caddy ingress status. `ready` is a direct Deployment-proxy comparison (multi-resource non-Helm
  * composition → no `Cel.expr`/conditions array): `status.readyReplicas >= spec.replicas`. The Deployment

package/dist/factories/caddy/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/factories/caddy/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,yDAAyD;AACzD,MAAM,+BAA+B,GAAG;IACtC,WAAW,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE;IACtD,SAAS,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE;CAC5C,CAAC;AAEX;;;;GAIG;AACH,MAAM,sBAAsB,GAAG;IAC7B,OAAO,EAAE,QAAQ;IACjB,eAAe,EAAE,QAAQ;CACjB,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;IAC3C,GAAG,EAAE,QAAQ;IACb,IAAI,EAAE,QAAQ;IACd,YAAY,EAAE,QAAQ;IACtB,0GAA0G;IAC1G,SAAS,EAAE,QAAQ;IACnB,2EAA2E;IAC3E,QAAQ,EAAE,QAAQ;IAClB;;;OAGG;IACH,UAAU,EAAE,QAAQ;IACpB,kEAAkE;IAClE,WAAW,EAAE,QAAQ;IACrB,oEAAoE;IACpE,YAAY,EAAE,QAAQ;IACtB,sFAAsF;IACtF,cAAc,EAAE,2CAA2C;IAC3D,qGAAqG;IACrG,cAAc,EAAE,sBAAsB;IACtC,YAAY,EAAE,+BAA+B;CAC9C,CAAC,CAAC;AAGH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;IAC3C,KAAK,EAAE,SAAS;IAChB,UAAU,EAAE,QAAQ;CACrB,CAAC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/factories/caddy/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,yDAAyD;AACzD,MAAM,+BAA+B,GAAG;IACtC,WAAW,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE;IACtD,SAAS,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE;CAC5C,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,sBAAsB,GAAG;IAC7B,OAAO,EAAE,QAAQ;IACjB,eAAe,EAAE,QAAQ;CACjB,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,qBAAqB,GAAG;IAC5B,GAAG,EAAE,QAAQ;IACb,IAAI,EAAE,QAAQ;IACd,YAAY,EAAE,QAAQ;IACtB,0GAA0G;IAC1G,SAAS,EAAE,QAAQ;IACnB,2EAA2E;IAC3E,QAAQ,EAAE,QAAQ;IAClB;;;OAGG;IACH,UAAU,EAAE,QAAQ;IACpB,kEAAkE;IAClE,WAAW,EAAE,QAAQ;IACrB,oEAAoE;IACpE,YAAY,EAAE,QAAQ;IACtB,sFAAsF;IACtF,cAAc,EAAE,2CAA2C;IAC3D,YAAY,EAAE,+BAA+B;CACrC,CAAC;AAEX,0FAA0F;AAC1F,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;IAC3C,GAAG,qBAAqB;IACxB,qGAAqG;IACrG,cAAc,EAAE,sBAAsB;CACvC,CAAC,CAAC;AAGH;;;;GAIG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,IAAI,CAAC,EAAE,GAAG,qBAAqB,EAAE,CAAC,CAAC;AAGpF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;IAC3C,KAAK,EAAE,SAAS;IAChB,UAAU,EAAE,QAAQ;CACrB,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "typekro",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "description": "A control plane aware framework for orchestrating kubernetes resources like a programmer.",
   "type": "module",
   "repository": {