@api-client/core 0.20.2 → 0.20.4

package/src/modeling/types.ts

@@ -127,6 +127,58 @@ export interface SchemaDefaultValue {
    * It is always a string and it has to be casted to the property's data type.
    */
   value: string | FunctionValue
+  /**
+   * When the `value` is a function, the `config` property is used to configure the function.
+   * The type of the config depends on the function and the property data type.
+   */
+  config?: FunctionGeneratorConfig
+}
+
+/**
+ * A union of all possible function generator configurations.
+ */
+export type FunctionGeneratorConfig = StringDefaultRandomGenerator
+
+/**
+ * Configuration for the `random` function for string properties.
+ */
+export interface StringDefaultRandomGenerator {
+  /**
+   * When set the `max` and `min` are used.
+   * Otherwise a random string of fixed length (the `fixed` property) is generated.
+   */
+  varyingLength?: boolean
+  /**
+   * The minimum length of the random string.
+   *
+   * When not specified, it defaults to `10`.
+   * The `varyingLength` must be `true` to use this property.
+   */
+  min?: number
+  /**
+   * The maximum length of the random string.
+   *
+   * When not specified, it defaults to `30`.
+   * The `varyingLength` must be `true` to use this property.
+   */
+  max?: number
+  /**
+   * The fixed length of the random string.
+   *
+   * When not specified, it defaults to `10`.
+   * The `varyingLength` must be `false` to use this property.
+   */
+  fixed?: number
+  /**
+   * The prefix to add to the random string.
+   * The prefix adds to the length of the random string.
+   */
+  prefix?: string
+  /**
+   * The suffix to add to the random string.
+   * The suffix adds to the length of the random string.
+   */
+  suffix?: string
 }
 
 /**

package/tests/unit/modeling/client_ip_address_semantic.spec.ts

@@ -5,8 +5,6 @@ import {
   isPropertySemantic,
   SemanticCategory,
   SemanticScope,
-  SemanticTiming,
-  SemanticOperation,
 } from '../../../src/modeling/Semantics.js'
 
 test.group('ClientIPAddress Semantic', () => {
@@ -48,24 +46,4 @@ test.group('ClientIPAddress Semantic', () => {
     const semantic = DataSemantics[SemanticType.ClientIPAddress]
     assert.isFalse(semantic.hasConfig)
   })
-
-  test('should have correct runtime configuration', ({ assert }) => {
-    const semantic = DataSemantics[SemanticType.ClientIPAddress]
-    const runtime = semantic.runtime
-
-    assert.equal(runtime.timing, SemanticTiming.Before)
-    assert.deepEqual(runtime.operations, [SemanticOperation.Create, SemanticOperation.Update])
-    assert.equal(runtime.priority, 95) // Low priority, populate after other validations
-    assert.equal(runtime.timeoutMs, 100) // Very fast operation
-  })
-
-  test('should have correct execution conditions', ({ assert }) => {
-    const semantic = DataSemantics[SemanticType.ClientIPAddress]
-    const conditions = semantic.runtime.conditions
-
-    assert.isDefined(conditions)
-    assert.lengthOf(conditions!, 1)
-    assert.equal(conditions![0].expression, 'entity[semantics.ClientIPAddress] == null')
-    assert.equal(conditions![0].description, 'Only set IP address if not already provided')
-  })
 })

package/tests/unit/modeling/semantics.spec.ts

@@ -3,8 +3,6 @@ import {
   SemanticType,
   SemanticScope,
   SemanticCategory,
-  SemanticTiming,
-  SemanticOperation,
   isEntitySemantic,
   isPropertySemantic,
   isAssociationSemantic,
@@ -52,10 +50,6 @@ test.group('Semantics', () => {
       scope: SemanticScope.Entity,
       category: SemanticCategory.Identity,
       hasConfig: false,
-      runtime: {
-        timing: SemanticTiming.None,
-        operations: [],
-      },
     }
     const propertySemantic: PropertySemantic = {
       id: SemanticType.CreatedTimestamp,
@@ -65,11 +59,6 @@ test.group('Semantics', () => {
       category: SemanticCategory.Lifecycle,
       hasConfig: false,
       applicableDataTypes: ['datetime'],
-      runtime: {
-        timing: SemanticTiming.Before,
-        operations: [SemanticOperation.Create],
-        priority: 90,
-      },
     }
     const associationSemantic: AssociationSemantic = {
       id: SemanticType.ResourceOwnerIdentifier,
@@ -78,18 +67,6 @@ test.group('Semantics', () => {
       scope: SemanticScope.Association,
       category: SemanticCategory.Identity,
       hasConfig: false,
-      runtime: {
-        timing: SemanticTiming.Before,
-        operations: [
-          SemanticOperation.Create,
-          SemanticOperation.Read,
-          SemanticOperation.Update,
-          SemanticOperation.Delete,
-          SemanticOperation.List,
-        ],
-        priority: 5,
-        canDisable: false,
-      },
     }
 
     assert.isTrue(isEntitySemantic(entitySemantic))
@@ -105,10 +82,6 @@ test.group('Semantics', () => {
       scope: SemanticScope.Entity,
       category: SemanticCategory.Identity,
       hasConfig: false,
-      runtime: {
-        timing: SemanticTiming.None,
-        operations: [],
-      },
     }
     const propertySemantic: PropertySemantic = {
       id: SemanticType.CreatedTimestamp,
@@ -118,11 +91,6 @@ test.group('Semantics', () => {
       category: SemanticCategory.Lifecycle,
       hasConfig: false,
       applicableDataTypes: ['datetime'],
-      runtime: {
-        timing: SemanticTiming.Before,
-        operations: [SemanticOperation.Create],
-        priority: 90,
-      },
     }
     const associationSemantic: AssociationSemantic = {
       id: SemanticType.ResourceOwnerIdentifier,
@@ -131,18 +99,6 @@ test.group('Semantics', () => {
       scope: SemanticScope.Association,
       category: SemanticCategory.Identity,
       hasConfig: false,
-      runtime: {
-        timing: SemanticTiming.Before,
-        operations: [
-          SemanticOperation.Create,
-          SemanticOperation.Read,
-          SemanticOperation.Update,
-          SemanticOperation.Delete,
-          SemanticOperation.List,
-        ],
-        priority: 5,
-        canDisable: false,
-      },
     }
 
     assert.isFalse(isPropertySemantic(entitySemantic))
@@ -158,10 +114,6 @@ test.group('Semantics', () => {
       scope: SemanticScope.Entity,
       category: SemanticCategory.Identity,
       hasConfig: false,
-      runtime: {
-        timing: SemanticTiming.None,
-        operations: [],
-      },
     }
     const propertySemantic: PropertySemantic = {
       id: SemanticType.CreatedTimestamp,
@@ -171,11 +123,6 @@ test.group('Semantics', () => {
       category: SemanticCategory.Lifecycle,
       hasConfig: false,
       applicableDataTypes: ['datetime'],
-      runtime: {
-        timing: SemanticTiming.Before,
-        operations: [SemanticOperation.Create],
-        priority: 90,
-      },
     }
     const associationSemantic: AssociationSemantic = {
       id: SemanticType.ResourceOwnerIdentifier,
@@ -184,18 +131,6 @@ test.group('Semantics', () => {
       scope: SemanticScope.Association,
       category: SemanticCategory.Identity,
       hasConfig: false,
-      runtime: {
-        timing: SemanticTiming.Before,
-        operations: [
-          SemanticOperation.Create,
-          SemanticOperation.Read,
-          SemanticOperation.Update,
-          SemanticOperation.Delete,
-          SemanticOperation.List,
-        ],
-        priority: 5,
-        canDisable: false,
-      },
     }
 
     assert.isFalse(isAssociationSemantic(entitySemantic))

package/tests/unit/modeling/username_semantic.spec.ts

@@ -5,8 +5,6 @@ import {
   isPropertySemantic,
   SemanticCategory,
   SemanticScope,
-  SemanticTiming,
-  SemanticOperation,
 } from '../../../src/modeling/Semantics.js'
 
 test.group('Username Semantic', () => {
@@ -48,34 +46,4 @@ test.group('Username Semantic', () => {
     const semantic = DataSemantics[SemanticType.Username]
     assert.isFalse(semantic.hasConfig)
   })
-
-  test('should not be disableable for security reasons', ({ assert }) => {
-    const semantic = DataSemantics[SemanticType.Username]
-    assert.isFalse(semantic.runtime.canDisable)
-  })
-
-  test('should have correct runtime configuration', ({ assert }) => {
-    const semantic = DataSemantics[SemanticType.Username]
-    const runtime = semantic.runtime
-
-    assert.equal(runtime.timing, SemanticTiming.Before)
-    assert.deepEqual(runtime.operations, [SemanticOperation.Create, SemanticOperation.Update, SemanticOperation.Read])
-    assert.equal(runtime.priority, 15) // High priority for authentication
-    assert.equal(runtime.timeoutMs, 100) // Fast operation
-  })
-
-  test('should have higher priority than general user properties but lower than password', ({ assert }) => {
-    const usernameSemantic = DataSemantics[SemanticType.Username]
-    const passwordSemantic = DataSemantics[SemanticType.Password]
-    const userRoleSemantic = DataSemantics[SemanticType.UserRole]
-
-    const usernameP = usernameSemantic.runtime.priority ?? 100
-    const passwordP = passwordSemantic.runtime.priority ?? 100
-    const userRoleP = userRoleSemantic.runtime.priority ?? 100
-
-    // Username should have lower priority number (higher priority) than UserRole
-    assert.isAtMost(usernameP, userRoleP)
-    // But higher priority number (lower priority) than Password
-    assert.isAtLeast(usernameP, passwordP)
-  })
 })

package/build/src/runtime/modeling/Semantics.d.ts

@@ -1,84 +0,0 @@
-import { Jexl } from '@pawel-up/jexl/Jexl.js';
-import type { DomainEntity } from '../../modeling/DomainEntity.js';
-import { type AppliedDataSemantic, type SemanticCondition, SemanticOperation, SemanticType } from '../../modeling/Semantics.js';
-import type { TransformFunction } from '@pawel-up/jexl';
-/**
- * Get or create a JEXL instance with optional custom transforms
- */
-export declare function getJexlInstance(transforms?: Record<string, TransformFunction>): Jexl;
-/**
- * Context object passed to semantic condition evaluation
- */
-export interface SemanticExecutionContext {
-    /**
-     * The entity data being processed
-     */
-    entity: Record<string, unknown>;
-    /**
-     * Current user context (if authenticated)
-     */
-    user?: {
-        id?: string;
-        authenticated?: boolean;
-        roles?: string[];
-        [key: string]: unknown;
-    };
-    /**
-     * The current database operation
-     */
-    operation: SemanticOperation;
-    /**
-     * Applied semantics with their field mappings
-     */
-    appliedSemantics: AppliedDataSemantic[];
-    /**
-     * Configuration for the current semantic being evaluated
-     */
-    config?: Record<string, unknown>;
-}
-/**
- * Builds a semantics object for JEXL evaluation that maps semantic types to actual field names.
- *
- * The resulting map should be used in JEXL expressions to reference semantic fields.
- *
- * @returns A map where keys are semantic type identifiers and values are the field names.
- *
- * @example
- * const semanticFieldMap = buildSemanticFieldMap(entity);
- * const result = await jexl.eval("semantics.CreatedTimestamp == null", {
- *  semantics: semanticFieldMap,
- *  ...
- * }
- */
-export declare function buildSemanticFieldMap(entity: DomainEntity): Record<string, string>;
-/**
- * Evaluates a semantic condition against the execution context
- * In a real implementation, this would use JEXL to evaluate the expression
- *
- * @param condition The semantic condition to evaluate
- * @param context The execution context containing entity data, user info, etc.
- * @param semanticFieldMap A map of semantic field names to their actual field names.
- *                         Use the `buildSemanticFieldMap()` function to create this map.
- * @param jexl Optional JEXL instance to use for evaluation, defaults to a cached instance.
- * @returns A promise that resolves to true if the condition is met, false otherwise
- */
-export declare function evaluateSemanticCondition(condition: SemanticCondition, context: SemanticExecutionContext, semanticFieldMap: Record<string, string>, jexl?: Jexl): Promise<boolean>;
-/**
- * Check if semantic should execute based on all its conditions
- *
- * @param semantic The semantic to check
- * @param context The execution context containing entity data, user info, etc.
- * @param semanticFieldMap A map of semantic field names to their actual field names.
- *                         Use the `buildSemanticFieldMap()` function to create this map.
- * @return A promise that resolves to true if all conditions are met, false otherwise
- */
-export declare function shouldSemanticExecute(semantic: AppliedDataSemantic, context: SemanticExecutionContext, semanticFieldMap: Record<string, string>): Promise<boolean>;
-/**
- * Helper to get the actual field name for a semantic type
- */
-export declare function getFieldNameForSemantic(semanticType: SemanticType, semanticFieldMap: Record<string, string>): string | undefined;
-/**
- * Validates that all semantic references in conditions are available
- */
-export declare function validateSemanticConditions(semantic: AppliedDataSemantic, semanticFieldMap: Record<string, string>): string[];
-//# sourceMappingURL=Semantics.d.ts.map

package/build/src/runtime/modeling/Semantics.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Semantics.d.ts","sourceRoot":"","sources":["../../../../src/runtime/modeling/Semantics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAA;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAClE,OAAO,EACL,KAAK,mBAAmB,EAExB,KAAK,iBAAiB,EACtB,iBAAiB,EACjB,YAAY,EACb,MAAM,6BAA6B,CAAA;AACpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAOvD;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,IAAI,CAcpF;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B;;OAEG;IACH,IAAI,CAAC,EAAE;QACL,EAAE,CAAC,EAAE,MAAM,CAAA;QACX,aAAa,CAAC,EAAE,OAAO,CAAA;QACvB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;QAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KACvB,CAAA;IACD;;OAEG;IACH,SAAS,EAAE,iBAAiB,CAAA;IAC5B;;OAEG;IACH,gBAAgB,EAAE,mBAAmB,EAAE,CAAA;IACvC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiBlF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,wBAAwB,EACjC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACxC,IAAI,GAAE,IAAwB,GAC7B,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE,wBAAwB,EACjC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACvC,OAAO,CAAC,OAAO,CAAC,CAalB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,YAAY,EAC1B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACvC,MAAM,GAAG,SAAS,CAGpB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,mBAAmB,EAC7B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACvC,MAAM,EAAE,CAuBV"}

package/build/src/runtime/modeling/Semantics.js

@@ -1,124 +0,0 @@
-import { Jexl } from '@pawel-up/jexl/Jexl.js';
-import { DataSemantics, } from '../../modeling/Semantics.js';
-/**
- * Cache for JEXL instances to avoid recreation overhead
- */
-const jexlCache = new Map();
-/**
- * Get or create a JEXL instance with optional custom transforms
- */
-export function getJexlInstance(transforms) {
-    const cacheKey = transforms ? JSON.stringify(Object.keys(transforms).sort()) : 'default';
-    if (!jexlCache.has(cacheKey)) {
-        const jexl = new Jexl();
-        if (transforms) {
-            Object.entries(transforms).forEach(([name, fn]) => {
-                jexl.addTransform(name, fn);
-            });
-        }
-        jexlCache.set(cacheKey, jexl);
-    }
-    return jexlCache.get(cacheKey);
-}
-/**
- * Builds a semantics object for JEXL evaluation that maps semantic types to actual field names.
- *
- * The resulting map should be used in JEXL expressions to reference semantic fields.
- *
- * @returns A map where keys are semantic type identifiers and values are the field names.
- *
- * @example
- * const semanticFieldMap = buildSemanticFieldMap(entity);
- * const result = await jexl.eval("semantics.CreatedTimestamp == null", {
- *  semantics: semanticFieldMap,
- *  ...
- * }
- */
-export function buildSemanticFieldMap(entity) {
-    const semanticFieldMap = {};
-    for (const property of entity.properties) {
-        if (!property.info.name) {
-            continue; // Skip properties without a name
-        }
-        for (const semantic of property.semantics) {
-            // We use the truncated `semantic.id` as the key, e.g. 'Password' so that it is possible to do something like:
-            // `entity[semantics.Password] != null && !entity[semantics.Password].startsWith('$')`
-            // Where the `semantics` object is the object returned by this function and
-            // passed to the JEXL context.
-            const semanticKey = semantic.id.replace('Semantic#', '');
-            semanticFieldMap[semanticKey] = property.info.name;
-        }
-    }
-    return semanticFieldMap;
-}
-/**
- * Evaluates a semantic condition against the execution context
- * In a real implementation, this would use JEXL to evaluate the expression
- *
- * @param condition The semantic condition to evaluate
- * @param context The execution context containing entity data, user info, etc.
- * @param semanticFieldMap A map of semantic field names to their actual field names.
- *                         Use the `buildSemanticFieldMap()` function to create this map.
- * @param jexl Optional JEXL instance to use for evaluation, defaults to a cached instance.
- * @returns A promise that resolves to true if the condition is met, false otherwise
- */
-export function evaluateSemanticCondition(condition, context, semanticFieldMap, jexl = getJexlInstance()) {
-    // Build the evaluation context
-    const evalContext = {
-        entity: context.entity,
-        user: context.user,
-        operation: context.operation,
-        config: context.config,
-        semantics: semanticFieldMap,
-    };
-    return jexl.eval(condition.expression, evalContext);
-}
-/**
- * Check if semantic should execute based on all its conditions
- *
- * @param semantic The semantic to check
- * @param context The execution context containing entity data, user info, etc.
- * @param semanticFieldMap A map of semantic field names to their actual field names.
- *                         Use the `buildSemanticFieldMap()` function to create this map.
- * @return A promise that resolves to true if all conditions are met, false otherwise
- */
-export async function shouldSemanticExecute(semantic, context, semanticFieldMap) {
-    const definition = DataSemantics[semantic.id];
-    const conditions = definition?.runtime?.conditions;
-    if (!conditions || conditions.length === 0) {
-        return true;
-    }
-    const results = await Promise.all(conditions.map((condition) => evaluateSemanticCondition(condition, context, semanticFieldMap)));
-    // All conditions must evaluate to true
-    return results.every((result) => result === true);
-}
-/**
- * Helper to get the actual field name for a semantic type
- */
-export function getFieldNameForSemantic(semanticType, semanticFieldMap) {
-    const semanticKey = semanticType.replace('Semantic#', '');
-    return semanticFieldMap[semanticKey];
-}
-/**
- * Validates that all semantic references in conditions are available
- */
-export function validateSemanticConditions(semantic, semanticFieldMap) {
-    const definition = DataSemantics[semantic.id];
-    const conditions = definition?.runtime?.conditions || [];
-    const errors = [];
-    conditions.forEach((condition, index) => {
-        // Extract semantic references from the condition expression
-        // Look for patterns like "semantics.CreatedTimestamp" or "entity[semantics.Password]"
-        const semanticMatches = condition.expression.match(/semantics\.(\w+)/g);
-        if (semanticMatches) {
-            semanticMatches.forEach((match) => {
-                const semanticKey = match.replace('semantics.', '');
-                if (!semanticFieldMap[semanticKey]) {
-                    errors.push(`Condition ${index + 1} references semantic "${semanticKey}" but no field with that semantic was found`);
-                }
-            });
-        }
-    });
-    return errors;
-}
-//# sourceMappingURL=Semantics.js.map

package/build/src/runtime/modeling/Semantics.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Semantics.js","sourceRoot":"","sources":["../../../../src/runtime/modeling/Semantics.ts"],"names":[],"mappings":"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","sourcesContent":["import { Jexl } from '@pawel-up/jexl/Jexl.js'\nimport type { DomainEntity } from '../../modeling/DomainEntity.js'\nimport {\n  type AppliedDataSemantic,\n  DataSemantics,\n  type SemanticCondition,\n  SemanticOperation,\n  SemanticType,\n} from '../../modeling/Semantics.js'\nimport type { TransformFunction } from '@pawel-up/jexl'\n\n/**\n * Cache for JEXL instances to avoid recreation overhead\n */\nconst jexlCache = new Map<string, Jexl>()\n\n/**\n * Get or create a JEXL instance with optional custom transforms\n */\nexport function getJexlInstance(transforms?: Record<string, TransformFunction>): Jexl {\n  const cacheKey = transforms ? JSON.stringify(Object.keys(transforms).sort()) : 'default'\n\n  if (!jexlCache.has(cacheKey)) {\n    const jexl = new Jexl()\n    if (transforms) {\n      Object.entries(transforms).forEach(([name, fn]) => {\n        jexl.addTransform(name, fn)\n      })\n    }\n    jexlCache.set(cacheKey, jexl)\n  }\n\n  return jexlCache.get(cacheKey) as Jexl\n}\n\n/**\n * Context object passed to semantic condition evaluation\n */\nexport interface SemanticExecutionContext {\n  /**\n   * The entity data being processed\n   */\n  entity: Record<string, unknown>\n  /**\n   * Current user context (if authenticated)\n   */\n  user?: {\n    id?: string\n    authenticated?: boolean\n    roles?: string[]\n    [key: string]: unknown\n  }\n  /**\n   * The current database operation\n   */\n  operation: SemanticOperation\n  /**\n   * Applied semantics with their field mappings\n   */\n  appliedSemantics: AppliedDataSemantic[]\n  /**\n   * Configuration for the current semantic being evaluated\n   */\n  config?: Record<string, unknown>\n}\n\n/**\n * Builds a semantics object for JEXL evaluation that maps semantic types to actual field names.\n *\n * The resulting map should be used in JEXL expressions to reference semantic fields.\n *\n * @returns A map where keys are semantic type identifiers and values are the field names.\n *\n * @example\n * const semanticFieldMap = buildSemanticFieldMap(entity);\n * const result = await jexl.eval(\"semantics.CreatedTimestamp == null\", {\n *  semantics: semanticFieldMap,\n *  ...\n * }\n */\nexport function buildSemanticFieldMap(entity: DomainEntity): Record<string, string> {\n  const semanticFieldMap: Record<string, string> = {}\n\n  for (const property of entity.properties) {\n    if (!property.info.name) {\n      continue // Skip properties without a name\n    }\n    for (const semantic of property.semantics) {\n      // We use the truncated `semantic.id` as the key, e.g. 'Password' so that it is possible to do something like:\n      // `entity[semantics.Password] != null && !entity[semantics.Password].startsWith('$')`\n      // Where the `semantics` object is the object returned by this function and\n      // passed to the JEXL context.\n      const semanticKey = semantic.id.replace('Semantic#', '')\n      semanticFieldMap[semanticKey] = property.info.name\n    }\n  }\n  return semanticFieldMap\n}\n\n/**\n * Evaluates a semantic condition against the execution context\n * In a real implementation, this would use JEXL to evaluate the expression\n *\n * @param condition The semantic condition to evaluate\n * @param context The execution context containing entity data, user info, etc.\n * @param semanticFieldMap A map of semantic field names to their actual field names.\n *                         Use the `buildSemanticFieldMap()` function to create this map.\n * @param jexl Optional JEXL instance to use for evaluation, defaults to a cached instance.\n * @returns A promise that resolves to true if the condition is met, false otherwise\n */\nexport function evaluateSemanticCondition(\n  condition: SemanticCondition,\n  context: SemanticExecutionContext,\n  semanticFieldMap: Record<string, string>,\n  jexl: Jexl = getJexlInstance()\n): Promise<boolean> {\n  // Build the evaluation context\n  const evalContext = {\n    entity: context.entity,\n    user: context.user,\n    operation: context.operation,\n    config: context.config,\n    semantics: semanticFieldMap,\n  }\n  return jexl.eval(condition.expression, evalContext)\n}\n\n/**\n * Check if semantic should execute based on all its conditions\n *\n * @param semantic The semantic to check\n * @param context The execution context containing entity data, user info, etc.\n * @param semanticFieldMap A map of semantic field names to their actual field names.\n *                         Use the `buildSemanticFieldMap()` function to create this map.\n * @return A promise that resolves to true if all conditions are met, false otherwise\n */\nexport async function shouldSemanticExecute(\n  semantic: AppliedDataSemantic,\n  context: SemanticExecutionContext,\n  semanticFieldMap: Record<string, string>\n): Promise<boolean> {\n  const definition = DataSemantics[semantic.id]\n  const conditions = definition?.runtime?.conditions\n\n  if (!conditions || conditions.length === 0) {\n    return true\n  }\n\n  const results = await Promise.all(\n    conditions.map((condition) => evaluateSemanticCondition(condition, context, semanticFieldMap))\n  )\n  // All conditions must evaluate to true\n  return results.every((result) => result === true)\n}\n\n/**\n * Helper to get the actual field name for a semantic type\n */\nexport function getFieldNameForSemantic(\n  semanticType: SemanticType,\n  semanticFieldMap: Record<string, string>\n): string | undefined {\n  const semanticKey = semanticType.replace('Semantic#', '')\n  return semanticFieldMap[semanticKey]\n}\n\n/**\n * Validates that all semantic references in conditions are available\n */\nexport function validateSemanticConditions(\n  semantic: AppliedDataSemantic,\n  semanticFieldMap: Record<string, string>\n): string[] {\n  const definition = DataSemantics[semantic.id]\n  const conditions = definition?.runtime?.conditions || []\n  const errors: string[] = []\n\n  conditions.forEach((condition, index) => {\n    // Extract semantic references from the condition expression\n    // Look for patterns like \"semantics.CreatedTimestamp\" or \"entity[semantics.Password]\"\n    const semanticMatches = condition.expression.match(/semantics\\.(\\w+)/g)\n\n    if (semanticMatches) {\n      semanticMatches.forEach((match) => {\n        const semanticKey = match.replace('semantics.', '')\n        if (!semanticFieldMap[semanticKey]) {\n          errors.push(\n            `Condition ${index + 1} references semantic \"${semanticKey}\" but no field with that semantic was found`\n          )\n        }\n      })\n    }\n  })\n\n  return errors\n}\n"]}