typekro 0.8.0 → 0.9.0

package/dist/core/serialization/cel-references.d.ts

@@ -20,6 +20,80 @@ import type { SerializationContext } from '../types/serialization.js';
  * This is the authoritative implementation.
  */
 export declare function getInnerCelPath(ref: KubernetesRef<unknown>): string;
+/** Convert marker strings to bare CEL paths using the full serialization context. */
+export declare function normalizeRefMarkersToCelPaths(str: string, context?: SerializationContext): string;
+/**
+ * Classify an expression as static (iff, after resolving all nested-
+ * composition references and schema markers, it contains no references
+ * to real-resource `status`/`metadata`/`spec` fields) or dynamic.
+ *
+ * This is the authoritative depth-agnostic static/dynamic classifier.
+ * It supersedes the local syntactic check in `validation/cel-validator.ts`
+ * for nested-composition references.
+ *
+ * Input shapes accepted:
+ *  - CEL expression strings (e.g., `"app.status.readyReplicas >= 1"`)
+ *  - Marker strings (e.g., `"http://__KUBERNETES_REF___schema___spec.name__"`)
+ *  - Mixed: CEL paths + marker tokens + literals
+ *
+ * Returns `true` iff the fully-resolved expression is purely
+ * schema-and-literal.
+ */
+export declare function isStaticExpression(expr: string, nestedStatusCel: Record<string, string> | undefined): boolean;
+/**
+ * Look up a nested composition's analyzed expression by `(resourceId, fieldName)`.
+ *
+ * **Single source of truth** for the nested-status match strategy. Used by
+ * every code path that needs to find an inner expression from a
+ * `nestedStatusCel` table — both the structured-ref paths
+ * (`generateCelExpression`, `serializeStatusMappingsToCel`) and the
+ * string-resolver path (`substituteNestedRefsOnce`,
+ * `resolveNestedRefMarkers`).
+ *
+ * Returns `undefined` when no match is found, leaving the caller to
+ * decide how to handle missing entries (typically: leave the reference
+ * in place and let downstream validation flag it).
+ *
+ * Match priority:
+ *  1. **Exact baseId match.** The reference uses the virtual nested
+ *     composition baseId verbatim (e.g., from a template literal on a
+ *     nested status proxy where `toString()` embeds the baseId).
+ *  2. **Base-name match (instance digits stripped).** Both the requested
+ *     id and the candidate baseIds have their trailing instance digits
+ *     stripped, then compared for equality. Handles the case where the
+ *     reference uses `webAppWithProcessing2` but the table has
+ *     `webAppWithProcessing1`.
+ *  3. **Unambiguous camelCase / case-insensitive prefix.** The
+ *     reference uses a name that structurally relates to one (and only
+ *     one) baseId stem (e.g., `inngest` matching `inngestBootstrap`).
+ *  4. **Field-name uniqueness.** When exactly one nested composition in
+ *     the table provides the requested field, use it. Handles the case
+ *     of arbitrary local variable names (e.g.,
+ *     `const stack = webAppWithProcessing(...); stack.status.databaseUrl`).
+ *
+ * Ambiguous matches (multiple candidates from the prefix or field-name
+ * strategies) emit a warning log and return `undefined` so the caller
+ * can fall through to its own error handling.
+ */
+export declare function lookupNestedExpression(resourceId: string, fieldName: string, nestedStatusCel: Record<string, string>, allowFieldFallback?: boolean): string | undefined;
+export declare function inlineNestedStatusRefs(expr: string, nestedStatusCel: Record<string, string> | undefined, resourceIds?: ReadonlySet<string>): string;
+/**
+ * Produce the final KRO CEL form for a nested-composition value, with all
+ * nested references substituted in and all schema markers converted to
+ * mixed-template form.
+ *
+ * The return value is always a valid KRO expression string ready to be
+ * embedded directly into a YAML value position (resource template field,
+ * status CEL expression). Three cases are handled:
+ *
+ *  - Marker-laden input (from a template literal) → converted to KRO
+ *    mixed-template form via {@link convertKubernetesRefMarkersTocel}.
+ *  - Input that already contains `${…}` segments (from a `Cel.template()`
+ *    call, for example) → returned as-is; assumed to be in KRO form.
+ *  - Plain-CEL input (raw CEL with no markers or `${…}`) → wrapped in
+ *    `${…}` so KRO recognizes it as an expression to evaluate.
+ */
+export declare function finalizeCelForKro(expr: string, nestedStatusCel: Record<string, string> | undefined, context?: SerializationContext): string;
 /**
  * Recursively replace all {@link KubernetesRef} objects with CEL expressions
  * for Kro YAML output.
@@ -32,5 +106,5 @@ export declare function processResourceReferences(obj: unknown, context?: Serial
  *
  * Only processes dynamic fields that require Kro resolution.
  */
-export declare function serializeStatusMappingsToCel(statusMappings: Record<string, unknown>, nestedStatusCel?: Record<string, string>, resourceIds?: Set<string>): Record<string, string | Record<string, unknown>>;
+export declare function serializeStatusMappingsToCel(statusMappings: Record<string, unknown>, nestedStatusCel?: Record<string, string>, resourceIds?: Set<string>, resourceAliases?: ReadonlyMap<string, string>): Record<string, string | Record<string, unknown> | unknown[]>;
 //# sourceMappingURL=cel-references.d.ts.map

package/dist/core/serialization/cel-references.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cel-references.d.ts","sourceRoot":"","sources":["../../../src/core/serialization/cel-references.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAQtE;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,MAAM,CAGnE;AAqHD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAuD/F;AAMD;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACxC,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACxB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA4JlD"}
+{"version":3,"file":"cel-references.d.ts","sourceRoot":"","sources":["../../../src/core/serialization/cel-references.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAYtE;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,MAAM,CAGnE;AA0LD,qFAAqF;AACrF,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAajG;AA6DD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAClD,OAAO,CAIT;AAmBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACvC,kBAAkB,GAAE,OAAc,GACjC,MAAM,GAAG,SAAS,CA2EpB;AAmDD,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACnD,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAChC,MAAM,CAER;AA2HD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACnD,OAAO,CAAC,EAAE,oBAAoB,GAC7B,MAAM,CAUR;AA0ED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAgE/F;AAMD;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACxC,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EACzB,eAAe,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,CAAC,CAkL9D"}