typekro 0.16.1 → 0.18.0

package/dist/factories/caddy/types.d.ts

@@ -3,35 +3,30 @@
  *
  * 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
  * `.map()`-ed into a string (see integration-skill rules 32/48). Use the exported `renderCaddyfile()`
  * helper to build the string from routes in concrete (consumer/direct) contexts, then pass it here.
  */
-/**
- * Caddy ingress config. `caddyfile` is the raw Caddyfile content (the routing + TLS config), supplied as
- * a string so it passes through unchanged in both direct and KRO modes.
- *
- * Undeclared keys are REJECTED (`'+': 'reject'`) so misconfig fails loudly rather than being silently
- * 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.
- */
+/** The default (PVC-backed) Caddy-ingress config. `persistence` sizes the `/data` PVC. */
 export declare const CaddyIngressConfigSchema: import("arktype/internal/variants/object.ts").ObjectType<{
     name: string;
     caddyfile: string;
+    persistence?: {
+        size?: string;
+        storageClass?: string;
+    };
     namespace?: string;
     image?: string;
     version?: string;
     httpPort?: number;
     httpsPort?: number;
     serviceType?: "ClusterIP" | "NodePort" | "LoadBalancer";
-    persistence?: {
-        size?: string;
-        storageClass?: string;
-    };
     resources?: {
         requests?: {
             cpu?: string;
@@ -44,6 +39,32 @@ export declare const CaddyIngressConfigSchema: import("arktype/internal/variants
     };
 }, {}>;
 export type CaddyIngressConfig = typeof CaddyIngressConfigSchema.infer;
+/**
+ * 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 declare const CaddyIngressEphemeralConfigSchema: import("arktype/internal/variants/object.ts").ObjectType<{
+    name: string;
+    caddyfile: string;
+    namespace?: string;
+    image?: string;
+    version?: string;
+    httpPort?: number;
+    httpsPort?: number;
+    serviceType?: "ClusterIP" | "NodePort" | "LoadBalancer";
+    resources?: {
+        requests?: {
+            cpu?: string;
+            memory?: string;
+        };
+        limits?: {
+            cpu?: string;
+            memory?: string;
+        };
+    };
+}, {}>;
+export type CaddyIngressEphemeralConfig = typeof CaddyIngressEphemeralConfigSchema.infer;
 /**
  * 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.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/factories/caddy/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAoBH;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;MAsBnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,wBAAwB,CAAC,KAAK,CAAC;AAEvE;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB;;;MAGnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,wBAAwB,CAAC,KAAK,CAAC;AAEvE,uGAAuG;AACvG,MAAM,WAAW,UAAU;IACzB,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,qGAAqG;IACrG,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,uCAAuC;AACvC,MAAM,WAAW,sBAAsB;IACrC,8FAA8F;IAC9F,GAAG,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;CAC1B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/factories/caddy/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAoDH,0FAA0F;AAC1F,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;MAInC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,wBAAwB,CAAC,KAAK,CAAC;AAEvE;;;;GAIG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;MAAqC,CAAC;AACpF,MAAM,MAAM,2BAA2B,GAAG,OAAO,iCAAiC,CAAC,KAAK,CAAC;AAEzF;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB;;;MAGnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,wBAAwB,CAAC,KAAK,CAAC;AAEvE,uGAAuG;AACvG,MAAM,WAAW,UAAU;IACzB,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,qGAAqG;IACrG,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,uCAAuC;AACvC,MAAM,WAAW,sBAAsB;IACrC,8FAA8F;IAC9F,GAAG,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;CAC1B"}

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.18.0",
   "description": "A control plane aware framework for orchestrating kubernetes resources like a programmer.",
   "type": "module",
   "repository": {