typekro 0.3.1 → 0.5.0

package/dist/core/references/cel-evaluator.js

@@ -20,8 +20,9 @@
  * - Compile-time optimization (see cel-optimizer.ts)
  */
 import { evaluate, parse } from 'cel-js';
-import { isKubernetesRef } from '../../utils/index';
+import { isKubernetesRef } from '../../utils/type-guards.js';
 import { CEL_EXPRESSION_BRAND } from '../constants/brands.js';
+import { ensureError, TypeKroError } from '../errors.js';
 import { CelEvaluationError } from '../types/references.js';
 export class CelEvaluator {
     /**
@@ -60,7 +61,7 @@ export class CelEvaluator {
             return result;
         }
         catch (error) {
-            throw new CelEvaluationError(expression, error);
+            throw new CelEvaluationError(expression, ensureError(error));
         }
     }
     /**
@@ -70,7 +71,9 @@ export class CelEvaluator {
         try {
             const parseResult = parse(expression.expression);
             if (!parseResult.isSuccess) {
-                throw new Error('Failed to parse CEL expression');
+                throw new TypeKroError('Failed to parse CEL expression', 'CEL_PARSE_FAILED', {
+                    expression: expression.expression,
+                });
             }
             return async (context) => {
                 const celContext = await this.buildCelContext(expression, context);
@@ -102,7 +105,7 @@ export class CelEvaluator {
             };
         }
         catch (error) {
-            throw new CelEvaluationError(expression, error);
+            throw new CelEvaluationError(expression, ensureError(error));
         }
     }
     /**
@@ -124,7 +127,7 @@ export class CelEvaluator {
         catch (error) {
             return {
                 valid: false,
-                error: error instanceof Error ? error.message : String(error),
+                error: ensureError(error).message,
             };
         }
     }
@@ -132,7 +135,7 @@ export class CelEvaluator {
      * Build the context object for cel-js evaluation
      */
     async buildCelContext(expression, context) {
-        const celContext = {};
+        const celContext = Object.create(null);
         // Add variables to context
         if (context.variables) {
             Object.assign(celContext, context.variables);
@@ -140,11 +143,21 @@ export class CelEvaluator {
         // Resolve resource references and add them to context
         const resourceRefs = this.extractResourceReferences(expression.expression);
         for (const ref of resourceRefs) {
-            const resource = context.resources.get(ref.resourceId);
+            let resource = context.resources.get(ref.resourceId);
+            // If not found, try case-insensitive lookup
+            if (!resource) {
+                const lowerResourceId = ref.resourceId.toLowerCase();
+                for (const [key, value] of context.resources.entries()) {
+                    if (key.toLowerCase() === lowerResourceId) {
+                        resource = value;
+                        break;
+                    }
+                }
+            }
             if (!resource) {
-                throw new Error(`Resource '${ref.resourceId}' not found in context`);
+                throw new TypeKroError(`Resource '${ref.resourceId}' not found in context`, 'RESOURCE_NOT_FOUND', { resourceId: ref.resourceId });
             }
-            // Add the entire resource to context using its ID
+            // Add the entire resource to context using its ID (use the original case from CEL expression)
             if (!celContext[ref.resourceId]) {
                 celContext[ref.resourceId] = resource;
             }
@@ -187,6 +200,25 @@ export class CelEvaluator {
             expression,
         };
     }
+    /**
+     * Escape a string for safe embedding in a CEL string literal.
+     * Prevents CEL injection by escaping quotes and backslashes.
+     */
+    static escapeCelString(value) {
+        return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+    }
+    /**
+     * Validate a CEL predicate/expression fragment to prevent injection.
+     * Rejects expressions containing string literals with unbalanced quotes
+     * or suspicious patterns that could indicate injection attempts.
+     */
+    static validateCelFragment(fragment, paramName) {
+        // Check for unbalanced double quotes (ignoring escaped ones)
+        const unescapedQuotes = fragment.replace(/\\"/g, '').match(/"/g);
+        if (unescapedQuotes && unescapedQuotes.length % 2 !== 0) {
+            throw new TypeKroError(`Invalid CEL ${paramName}: unbalanced quotes in "${fragment}"`, 'CEL_INJECTION_PREVENTED', { fragment, paramName });
+        }
+    }
     /**
      * Common CEL expression builders
      */
@@ -200,7 +232,7 @@ export class CelEvaluator {
                 if (isKubernetesRef(part)) {
                     return `${part.resourceId}.${part.fieldPath}`;
                 }
-                return `"${part}"`;
+                return `"${CelEvaluator.escapeCelString(part)}"`;
             })
                 .join(', ');
             return {
@@ -215,6 +247,10 @@ export class CelEvaluator {
             const conditionExpr = isKubernetesRef(condition)
                 ? `${condition.resourceId}.${condition.fieldPath}`
                 : condition;
+            // Validate the condition fragment if it's a raw string
+            if (!isKubernetesRef(condition)) {
+                CelEvaluator.validateCelFragment(conditionExpr, 'condition');
+            }
             return {
                 [CEL_EXPRESSION_BRAND]: true,
                 expression: `${conditionExpr} ? ${JSON.stringify(trueValue)} : ${JSON.stringify(falseValue)}`,
@@ -239,50 +275,62 @@ export class CelEvaluator {
          */
         contains: (ref, substring) => ({
             [CEL_EXPRESSION_BRAND]: true,
-            expression: `${ref.resourceId}.${ref.fieldPath}.contains("${substring}")`,
+            expression: `${ref.resourceId}.${ref.fieldPath}.contains("${CelEvaluator.escapeCelString(substring)}")`,
         }),
         /**
          * String starts with check: resource.field.startsWith("prefix")
          */
         startsWith: (ref, prefix) => ({
             [CEL_EXPRESSION_BRAND]: true,
-            expression: `${ref.resourceId}.${ref.fieldPath}.startsWith("${prefix}")`,
+            expression: `${ref.resourceId}.${ref.fieldPath}.startsWith("${CelEvaluator.escapeCelString(prefix)}")`,
         }),
         /**
          * String ends with check: resource.field.endsWith("suffix")
          */
         endsWith: (ref, suffix) => ({
             [CEL_EXPRESSION_BRAND]: true,
-            expression: `${ref.resourceId}.${ref.fieldPath}.endsWith("${suffix}")`,
+            expression: `${ref.resourceId}.${ref.fieldPath}.endsWith("${CelEvaluator.escapeCelString(suffix)}")`,
         }),
         /**
          * List/array operations: resource.field.all(x, x > 0)
          */
-        all: (ref, predicate) => ({
-            [CEL_EXPRESSION_BRAND]: true,
-            expression: `${ref.resourceId}.${ref.fieldPath}.all(x, ${predicate})`,
-        }),
+        all: (ref, predicate) => {
+            CelEvaluator.validateCelFragment(predicate, 'predicate');
+            return {
+                [CEL_EXPRESSION_BRAND]: true,
+                expression: `${ref.resourceId}.${ref.fieldPath}.all(x, ${predicate})`,
+            };
+        },
         /**
          * List/array operations: resource.field.exists(x, x > 0)
          */
-        exists: (ref, predicate) => ({
-            [CEL_EXPRESSION_BRAND]: true,
-            expression: `${ref.resourceId}.${ref.fieldPath}.exists(x, ${predicate})`,
-        }),
+        exists: (ref, predicate) => {
+            CelEvaluator.validateCelFragment(predicate, 'predicate');
+            return {
+                [CEL_EXPRESSION_BRAND]: true,
+                expression: `${ref.resourceId}.${ref.fieldPath}.exists(x, ${predicate})`,
+            };
+        },
         /**
          * List/array filter: resource.field.filter(x, x > 0)
          */
-        filter: (ref, predicate) => ({
-            [CEL_EXPRESSION_BRAND]: true,
-            expression: `${ref.resourceId}.${ref.fieldPath}.filter(x, ${predicate})`,
-        }),
+        filter: (ref, predicate) => {
+            CelEvaluator.validateCelFragment(predicate, 'predicate');
+            return {
+                [CEL_EXPRESSION_BRAND]: true,
+                expression: `${ref.resourceId}.${ref.fieldPath}.filter(x, ${predicate})`,
+            };
+        },
         /**
          * List/array map: resource.field.map(x, x * 2)
          */
-        map: (ref, transform) => ({
-            [CEL_EXPRESSION_BRAND]: true,
-            expression: `${ref.resourceId}.${ref.fieldPath}.map(x, ${transform})`,
-        }),
+        map: (ref, transform) => {
+            CelEvaluator.validateCelFragment(transform, 'transform');
+            return {
+                [CEL_EXPRESSION_BRAND]: true,
+                expression: `${ref.resourceId}.${ref.fieldPath}.map(x, ${transform})`,
+            };
+        },
     };
 }
 //# sourceMappingURL=cel-evaluator.js.map

package/dist/core/references/cel-evaluator.js.map

@@ -1 +1 @@
-{"version":3,"file":"cel-evaluator.js","sourceRoot":"","sources":["../../../src/core/references/cel-evaluator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cel-evaluator.js","sourceRoot":"","sources":["../../../src/core/references/cel-evaluator.ts"],"names":[],"mappings":"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"}

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

@@ -1,23 +1,44 @@
-import type { CelExpression, RefOrValue, SerializationContext } from '../types.js';
+import type { CelExpression, RefOrValue } from '../types.js';
+/**
+ * Build a CEL expression from parts. Accepts resource references (`schema.spec.*`,
+ * `resources.*.status.*`), other CEL expressions, and literal strings/numbers/booleans.
+ * Parts are concatenated directly (no spaces). Use `Cel.join` for spaced joining.
+ *
+ * The type parameter `T` constrains what the expression evaluates to at runtime,
+ * ensuring type safety through the serialization pipeline.
+ *
+ * @typeParam T - The CEL expression's result type (e.g., `boolean`, `string`, `number`)
+ *
+ * @example Status readiness check
+ * ```typescript
+ * ready: Cel.expr<boolean>(resources.deployment.status.readyReplicas, ' > 0')
+ * ```
+ *
+ * @example Conditional phase
+ * ```typescript
+ * phase: Cel.expr<string>(resources.helm.status.phase, ' == "Ready" ? "Ready" : "Installing"')
+ * ```
+ *
+ * @example Static value (backtick + quotes)
+ * ```typescript
+ * phase: Cel.expr<string>`'running'`
+ * ```
+ */
 declare function expr<T = unknown>(...parts: RefOrValue<unknown>[]): CelExpression<T> & T;
-declare function expr<T = unknown>(context: SerializationContext, ...parts: RefOrValue<unknown>[]): CelExpression<T> & T;
 /**
  * Convenience method for joining parts with automatic spacing.
  * Useful for building readable CEL expressions.
  */
 declare function join<T = unknown>(...parts: RefOrValue<unknown>[]): CelExpression<T> & T;
-declare function join<T = unknown>(context: SerializationContext, ...parts: RefOrValue<unknown>[]): CelExpression<T> & T;
 type CelValue = string | number | boolean | null | undefined;
 /**
  * Creates a conditional CEL expression: condition ? trueValue : falseValue
  */
 declare function conditional<T = unknown>(condition: RefOrValue<CelValue>, trueValue: RefOrValue<CelValue>, falseValue: RefOrValue<CelValue>): CelExpression<T> & T;
-declare function conditional<T = unknown>(context: SerializationContext, condition: RefOrValue<CelValue>, trueValue: RefOrValue<CelValue>, falseValue: RefOrValue<CelValue>): CelExpression<T> & T;
 /**
  * Creates a CEL expression for mathematical operations
  */
 declare function math<T = unknown>(operation: string, ...operands: RefOrValue<CelValue>[]): CelExpression<T> & T;
-declare function math<T = unknown>(context: SerializationContext, operation: string, ...operands: RefOrValue<CelValue>[]): CelExpression<T> & T;
 /**
  * Creates a mixed string template that combines literal strings with CEL expressions
  *
@@ -28,7 +49,6 @@ declare function math<T = unknown>(context: SerializationContext, operation: str
  * - template('%s-%s', prefix, suffix) -> "${prefix}-${suffix}"
  */
 declare function template(templateString: string, ...values: RefOrValue<CelValue>[]): CelExpression<string> & string;
-declare function template(context: SerializationContext, templateString: string, ...values: RefOrValue<CelValue>[]): CelExpression<string> & string;
 /**
  * Creates a CEL string concatenation expression using the + operator
  *
@@ -39,7 +59,6 @@ declare function template(context: SerializationContext, templateString: string,
  * - concat(prefix, '-', suffix) -> prefix + "-" + suffix
  */
 declare function concat(...parts: RefOrValue<CelValue>[]): CelExpression<string> & string;
-declare function concat(context: SerializationContext, ...parts: RefOrValue<CelValue>[]): CelExpression<string> & string;
 /**
  * Template literal tag function for creating CEL expressions from template literals
  * This allows natural template literal syntax while preserving KubernetesRef objects
@@ -52,7 +71,32 @@ declare function concat(context: SerializationContext, ...parts: RefOrValue<CelV
  */
 declare function cel<T = string>(strings: TemplateStringsArray, ...values: RefOrValue<unknown>[]): CelExpression<T> & T;
 /**
- * CEL utility functions
+ * CEL (Common Expression Language) utilities for building type-safe expressions
+ * in resource graph status builders.
+ *
+ * In Kro mode, CEL expressions are serialized into the RGD YAML and evaluated
+ * by the Kro operator at runtime. In Direct mode, they are evaluated locally
+ * using the `cel-js` library.
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { Cel } from 'typekro';
+ *
+ * // Boolean expression
+ * ready: Cel.expr<boolean>(resources.deploy.status.readyReplicas, ' > 0')
+ *
+ * // String template with %s placeholders
+ * url: Cel.template('https://%s/api', schema.spec.hostname)
+ *
+ * // Tagged template literal
+ * greeting: Cel.tag`Hello ${schema.spec.name}`
+ *
+ * // Conditional
+ * phase: Cel.conditional(resources.deploy.status.readyReplicas, '"Ready"', '"Pending"')
+ *
+ * // CEL built-in functions
+ * count: Cel.size(resources.deploy.status.readyReplicas)
+ * ```
  */
 export declare const Cel: {
     expr: typeof expr;
@@ -61,27 +105,26 @@ export declare const Cel: {
     math: typeof math;
     template: typeof template;
     concat: typeof concat;
-    cel: typeof cel;
+    /** Tagged template literal for CEL expressions. Alias: standalone `cel` export. */
+    tag: typeof cel;
+    /** Create a boolean CEL expression. Shorthand for Cel.expr<boolean>(...). */
+    boolean: (...parts: RefOrValue<unknown>[]) => CelExpression<boolean> & boolean;
+    /** Create a string CEL expression. Shorthand for Cel.expr<string>(...). */
+    str: (...parts: RefOrValue<unknown>[]) => CelExpression<string> & string;
+    /** Create a number CEL expression. Shorthand for Cel.expr<number>(...). */
+    number: (...parts: RefOrValue<unknown>[]) => CelExpression<number> & number;
+    /** CEL `min()` — returns the smallest of the given values. */
     min: (...values: RefOrValue<CelValue>[]) => CelExpression<number> & number;
+    /** CEL `max()` — returns the largest of the given values. */
     max: (...values: RefOrValue<CelValue>[]) => CelExpression<number> & number;
+    /** CEL `size()` — returns the length of a list, map, or string. */
     size: (collection: RefOrValue<CelValue>) => CelExpression<number> & number;
+    /** CEL `string()` — converts a value to its string representation. */
     string: (value: RefOrValue<CelValue>) => CelExpression<string> & string;
+    /** CEL `int()` — converts a value to an integer. */
     int: (value: RefOrValue<CelValue>) => CelExpression<number> & number;
+    /** CEL `double()` — converts a value to a floating-point number. */
     double: (value: RefOrValue<CelValue>) => CelExpression<number> & number;
-    withContext: (context: SerializationContext) => {
-        expr: (...parts: RefOrValue<CelValue>[]) => CelExpression<unknown>;
-        join: (...parts: RefOrValue<CelValue>[]) => CelExpression<unknown>;
-        conditional: (condition: RefOrValue<CelValue>, trueValue: RefOrValue<CelValue>, falseValue: RefOrValue<CelValue>) => CelExpression<unknown>;
-        math: (operation: string, ...operands: RefOrValue<CelValue>[]) => CelExpression<unknown>;
-        template: (templateString: string, ...values: RefOrValue<CelValue>[]) => CelExpression<string> & string;
-        concat: (...parts: RefOrValue<CelValue>[]) => CelExpression<string> & string;
-        min: (...values: RefOrValue<CelValue>[]) => CelExpression<number> & number;
-        max: (...values: RefOrValue<CelValue>[]) => CelExpression<number> & number;
-        size: (collection: RefOrValue<CelValue>) => CelExpression<number> & number;
-        string: (value: RefOrValue<CelValue>) => CelExpression<string> & string;
-        int: (value: RefOrValue<CelValue>) => CelExpression<number> & number;
-        double: (value: RefOrValue<CelValue>) => CelExpression<number> & number;
-    };
 };
 export { cel };
 //# sourceMappingURL=cel.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"cel.d.ts","sourceRoot":"","sources":["../../../src/core/references/cel.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cel.d.ts","sourceRoot":"","sources":["../../../src/core/references/cel.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAgF7D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,iBAAS,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CA+BhF;AAED;;;GAGG;AACH,iBAAS,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAWhF;AAGD,KAAK,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAE7D;;GAEG;AACH,iBAAS,WAAW,CAAC,CAAC,GAAG,OAAO,EAC9B,SAAS,EAAE,UAAU,CAAC,QAAQ,CAAC,EAC/B,SAAS,EAAE,UAAU,CAAC,QAAQ,CAAC,EAC/B,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,GAC/B,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAEtB;AAED;;GAEG;AACH,iBAAS,IAAI,CAAC,CAAC,GAAG,OAAO,EACvB,SAAS,EAAE,MAAM,EACjB,GAAG,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,EAAE,GAClC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAYtB;AAED;;;;;;;;GAQG;AACH,iBAAS,QAAQ,CACf,cAAc,EAAE,MAAM,EACtB,GAAG,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,EAAE,GAChC,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM,CAiChC;AAED;;;;;;;;GAQG;AACH,iBAAS,MAAM,CAAC,GAAG,KAAK,EAAE,UAAU,CAAC,QAAQ,CAAC,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM,CA6BhF;AAED;;;;;;;;;GASG;AACH,iBAAS,GAAG,CAAC,CAAC,GAAG,MAAM,EACrB,OAAO,EAAE,oBAAoB,EAC7B,GAAG,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,GAC/B,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAqCtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,GAAG;;;;;;;IAOd,mFAAmF;;IAInF,6EAA6E;wBACzD,UAAU,CAAC,OAAO,CAAC,EAAE,KAAG,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO;IAG5E,2EAA2E;oBAC3D,UAAU,CAAC,OAAO,CAAC,EAAE,KAAG,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM;IAEtE,2EAA2E;uBACxD,UAAU,CAAC,OAAO,CAAC,EAAE,KAAG,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM;IAKzE,8DAA8D;qBAC7C,UAAU,CAAC,QAAQ,CAAC,EAAE;IAEvC,6DAA6D;qBAC5C,UAAU,CAAC,QAAQ,CAAC,EAAE;IAEvC,mEAAmE;uBAChD,UAAU,CAAC,QAAQ,CAAC;IAEvC,sEAAsE;oBACtD,UAAU,CAAC,QAAQ,CAAC,KACD,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM;IAEjE,oDAAoD;iBACvC,UAAU,CAAC,QAAQ,CAAC;IAEjC,oEAAoE;oBACpD,UAAU,CAAC,QAAQ,CAAC;CACrC,CAAC;AAGF,OAAO,EAAE,GAAG,EAAE,CAAC"}