@api-client/core 0.18.23 → 0.18.25

package/data/models/example-generator-api.json

@@ -42062,7 +42062,7 @@
 "@id": "#209"
 },
 {
-"@id": "#197"
+"@id": "#206"
 },
 {
 "@id": "#191"
@@ -42071,13 +42071,13 @@
 "@id": "#194"
 },
 {
-"@id": "#200"
+"@id": "#197"
 },
 {
-"@id": "#206"
+"@id": "#203"
 },
 {
-"@id": "#203"
+"@id": "#200"
 },
 {
 "@id": "#209"
@@ -42810,15 +42810,15 @@
 "@id": "#219"
 },
 {
-"@id": "#216"
-},
-{
 "@id": "#210"
 },
 {
 "@id": "#213"
 },
 {
+"@id": "#216"
+},
+{
 "@id": "#219"
 }
 ],
@@ -43478,7 +43478,7 @@
 "doc:ExternalDomainElement",
 "doc:DomainElement"
 ],
-"doc:raw": "countryCode: \"BE\"\ngraydonEnterpriseId: 1057155523\nregistrationId: \"0422319093\"\nvatNumber: \"BE0422319093\"\ngraydonCompanyId: \"0422319093\"\nisBranchOffice: false\n",
+"doc:raw": "class: '3'\ndescription: '150 - 300'\nnumberOfFte: 5500\nnumberOfEmployees: 5232\n",
 "core:mediaType": "application/yaml",
 "sourcemaps:sources": [
 {
@@ -43499,7 +43499,7 @@
 "doc:ExternalDomainElement",
 "doc:DomainElement"
 ],
-"doc:raw": "class: '3'\ndescription: '150 - 300'\nnumberOfFte: 5500\nnumberOfEmployees: 5232\n",
+"doc:raw": "code: '7487'\ndescription: 'Financial and insurance activities'\ntype: \"PRIMARY\"\nclassificationCode: 'BE_NACEBEL2008'\nactivityGroupCode: 'ABCDE'\n",
 "core:mediaType": "application/yaml",
 "sourcemaps:sources": [
 {
@@ -43520,7 +43520,7 @@
 "doc:ExternalDomainElement",
 "doc:DomainElement"
 ],
-"doc:raw": "code: '7487'\ndescription: 'Financial and insurance activities'\ntype: \"PRIMARY\"\nclassificationCode: 'BE_NACEBEL2008'\nactivityGroupCode: 'ABCDE'\n",
+"doc:raw": "code: 'J'\ndescription: 'Information and communication'\n",
 "core:mediaType": "application/yaml",
 "sourcemaps:sources": [
 {
@@ -43541,7 +43541,7 @@
 "doc:ExternalDomainElement",
 "doc:DomainElement"
 ],
-"doc:raw": "code: 'J'\ndescription: 'Information and communication'\n",
+"doc:raw": "countryCode: \"BE\"\ngraydonEnterpriseId: 1057155523\nregistrationId: \"0422319093\"\nvatNumber: \"BE0422319093\"\ngraydonCompanyId: \"0422319093\"\nisBranchOffice: false\n",
 "core:mediaType": "application/yaml",
 "sourcemaps:sources": [
 {
@@ -44232,7 +44232,7 @@
 "doc:ExternalDomainElement",
 "doc:DomainElement"
 ],
-"doc:raw": "type: 'GENERAL'\ncountryDialCode : '+32'\nareaCode : '21'\nsubscriberNumber: '12.87.00'\nformatted: '+32-(0)21 302099'\n",
+"doc:raw": "type: 'GENERAL'\ncountryDialCode : '+32'\nareaCode : '22'\nsubscriberNumber: '12.87.00'\nformatted: '+32-(0)22 000000'\n",
 "core:mediaType": "application/yaml",
 "sourcemaps:sources": [
 {
@@ -44253,7 +44253,7 @@
 "doc:ExternalDomainElement",
 "doc:DomainElement"
 ],
-"doc:raw": "-\n  type: 'GENERAL'\n  value: 'info@company.be'\n-\n  type: 'IT_DEPT'\n  value: 'it-service@company.be'\n",
+"doc:raw": "type: 'GENERAL'\ncountryDialCode : '+32'\nareaCode : '21'\nsubscriberNumber: '12.87.00'\nformatted: '+32-(0)21 302099'\n",
 "core:mediaType": "application/yaml",
 "sourcemaps:sources": [
 {
@@ -44274,7 +44274,7 @@
 "doc:ExternalDomainElement",
 "doc:DomainElement"
 ],
-"doc:raw": "type: 'GENERAL'\ncountryDialCode : '+32'\nareaCode : '22'\nsubscriberNumber: '12.87.00'\nformatted: '+32-(0)22 000000'\n",
+"doc:raw": "-\n  type: 'GENERAL'\n  value: 'info@company.be'\n-\n  type: 'IT_DEPT'\n  value: 'it-service@company.be'\n",
 "core:mediaType": "application/yaml",
 "sourcemaps:sources": [
 {
@@ -44766,22 +44766,22 @@
 {
 "@id": "#199/source-map/lexical/element_0",
 "sourcemaps:element": "amf://id#199",
-"sourcemaps:value": "[(1,0)-(7,0)]"
+"sourcemaps:value": "[(1,0)-(5,0)]"
 },
 {
 "@id": "#202/source-map/lexical/element_0",
 "sourcemaps:element": "amf://id#202",
-"sourcemaps:value": "[(1,0)-(5,0)]"
+"sourcemaps:value": "[(1,0)-(6,0)]"
 },
 {
 "@id": "#205/source-map/lexical/element_0",
 "sourcemaps:element": "amf://id#205",
-"sourcemaps:value": "[(1,0)-(6,0)]"
+"sourcemaps:value": "[(1,0)-(3,0)]"
 },
 {
 "@id": "#208/source-map/lexical/element_0",
 "sourcemaps:element": "amf://id#208",
-"sourcemaps:value": "[(1,0)-(3,0)]"
+"sourcemaps:value": "[(1,0)-(7,0)]"
 },
 {
 "@id": "#223/source-map/lexical/element_0",
@@ -45121,12 +45121,12 @@
 {
 "@id": "#215/source-map/lexical/element_0",
 "sourcemaps:element": "amf://id#215",
-"sourcemaps:value": "[(1,0)-(7,0)]"
+"sourcemaps:value": "[(1,0)-(6,0)]"
 },
 {
 "@id": "#218/source-map/lexical/element_0",
 "sourcemaps:element": "amf://id#218",
-"sourcemaps:value": "[(1,0)-(6,0)]"
+"sourcemaps:value": "[(1,0)-(7,0)]"
 },
 {
 "@id": "#221/source-map/lexical/element_0",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@api-client/core",
   "description": "The API Client's core client library. Works in NodeJS and in a ES enabled browser.",
-  "version": "0.18.23",
+  "version": "0.18.25",
   "license": "Apache-2.0",
   "exports": {
     "./browser.js": {

package/src/modeling/DomainEntity.ts

@@ -412,7 +412,7 @@ export class DomainEntity extends DomainElement {
    * ```
    */
   addParent(key: string, domain?: string): this {
-    const effectiveKey = domain ? `${domain}:${key}` : key
+    const effectiveKey = this.domain.buildReferenceKey(key, domain)
     // Prevent adding self as parent
     if (effectiveKey === this.key) {
       const message = 'Entity cannot be a parent of itself'
@@ -486,19 +486,41 @@ export class DomainEntity extends DomainElement {
    * Removes a parent from this entity.
    *
    * @param key The key of the parent entity to remove.
+   * @param domain Optional domain key if the parent belongs to a foreign domain.
    * @returns `this` for chaining.
    * @throws Error When the parent does not exist.
    * @example
    * ```typescript
+   * // Remove local parent
    * entity.removeParent('baseEntity');
+   *
+   * // Remove foreign domain parent
+   * entity.removeParent('baseEntity', 'externalDomain');
    * ```
    */
-  removeParent(key: string): this {
+  removeParent(key: string, domain?: string): this {
     const { graph } = this.root
-    if (!graph.hasEdge(this.key, key)) {
-      throw new Error(`Trying to remove a parent ${key} from ${this.key}, but it doesn't exist`)
+    const effectiveKey = this.domain.buildReferenceKey(key, domain)
+
+    if (!graph.hasEdge(this.key, effectiveKey)) {
+      let message = `Trying to remove a parent ${key} from ${this.key}, but it doesn't exist`
+      if (domain) {
+        message = `Trying to remove a foreign parent ${key} from domain "${domain}" from ${this.key}, but it doesn't exist`
+      }
+      throw new Error(message)
     }
-    graph.removeEdge(this.key, key)
+
+    // Verify it's actually a parent edge
+    const edge = graph.edge(this.key, effectiveKey)
+    if (!edge || edge.type !== 'parent') {
+      let message = `Edge between ${this.key} and ${key} exists but is not a parent relationship`
+      if (domain) {
+        message = `Edge between ${this.key} and ${key} in domain "${domain}" exists but is not a parent relationship`
+      }
+      throw new Error(message)
+    }
+
+    graph.removeEdge(this.key, effectiveKey)
     this.root.notifyChange()
     return this
   }

package/src/modeling/Semantics.ts

@@ -270,6 +270,65 @@ export enum SemanticCategory {
   Computed = 'Computed Values',
 }
 
+/**
+ * Defines when a semantic should execute in relation to database operations.
+ */
+export enum SemanticTiming {
+  /**
+   * Execute before the database operation (validation, preprocessing)
+   */
+  Before = 'Before',
+  /**
+   * Execute after the database operation (cleanup, notifications, derived values)
+   */
+  After = 'After',
+  /**
+   * Execute both before and after the operation
+   */
+  Both = 'Both',
+  /**
+   * No automatic execution (manual/on-demand only)
+   */
+  None = 'None',
+}
+
+/**
+ * Defines which database operations can trigger a semantic.
+ */
+export enum SemanticOperation {
+  Create = 'Create',
+  Read = 'Read',
+  Update = 'Update',
+  Delete = 'Delete',
+  /**
+   * Special operation for list/query operations
+   */
+  List = 'List',
+}
+
+/**
+ * Configuration for when and how a semantic should execute at runtime.
+ */
+export interface SemanticRuntimeConfig {
+  /**
+   * When the semantic should execute relative to the database operation.
+   */
+  timing: SemanticTiming
+  /**
+   * Which database operations should trigger this semantic.
+   */
+  operations: SemanticOperation[]
+  /**
+   * Priority order for execution when multiple semantics apply.
+   * Lower numbers execute first. Default is 100.
+   */
+  priority?: number
+  /**
+   * Whether this semantic can be disabled at the entity/property level.
+   */
+  canDisable?: boolean
+}
+
 /**
  * A base interface for all Data Semantics, containing common properties.
  * A semantic is an annotation applied to a Data Entity, Property, or Association
@@ -302,6 +361,10 @@ interface BaseDataSemantic {
    * This is used to determine if the semantic requires additional setup or configuration.
    */
   hasConfig: boolean
+  /**
+   * Runtime execution configuration for this semantic.
+   */
+  runtime: SemanticRuntimeConfig
 }
 
 /**
@@ -369,6 +432,10 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     description: 'System users and accounts',
     category: SemanticCategory.Identity,
     hasConfig: false,
+    runtime: {
+      timing: SemanticTiming.None,
+      operations: [],
+    },
   },
   [SemanticType.Password]: {
     id: SemanticType.Password,
@@ -378,6 +445,12 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     category: SemanticCategory.Identity,
     applicableDataTypes: ['string'],
     hasConfig: true,
+    runtime: {
+      timing: SemanticTiming.Before,
+      operations: [SemanticOperation.Create, SemanticOperation.Update],
+      priority: 10, // High priority for security
+      canDisable: false, // Security semantics cannot be disabled
+    },
   },
   [SemanticType.UserRole]: {
     id: SemanticType.UserRole,
@@ -387,6 +460,17 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     category: SemanticCategory.Identity,
     applicableDataTypes: ['string'],
     hasConfig: false,
+    runtime: {
+      timing: SemanticTiming.Before,
+      operations: [
+        SemanticOperation.Create,
+        SemanticOperation.Read,
+        SemanticOperation.Update,
+        SemanticOperation.Delete,
+        SemanticOperation.List,
+      ],
+      priority: 20,
+    },
   },
   [SemanticType.ResourceOwnerIdentifier]: {
     id: SemanticType.ResourceOwnerIdentifier,
@@ -395,6 +479,18 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     description: 'Links record to owner user',
     category: SemanticCategory.Identity,
     hasConfig: false,
+    runtime: {
+      timing: SemanticTiming.Before,
+      operations: [
+        SemanticOperation.Create,
+        SemanticOperation.Read,
+        SemanticOperation.Update,
+        SemanticOperation.Delete,
+        SemanticOperation.List,
+      ],
+      priority: 5, // Very high priority for access control
+      canDisable: false,
+    },
   },
 
   //
@@ -409,6 +505,11 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     category: SemanticCategory.Lifecycle,
     applicableDataTypes: ['datetime'],
     hasConfig: false,
+    runtime: {
+      timing: SemanticTiming.Before,
+      operations: [SemanticOperation.Create],
+      priority: 90,
+    },
   },
   [SemanticType.UpdatedTimestamp]: {
     id: SemanticType.UpdatedTimestamp,
@@ -418,6 +519,11 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     category: SemanticCategory.Lifecycle,
     applicableDataTypes: ['datetime'],
     hasConfig: false,
+    runtime: {
+      timing: SemanticTiming.Before,
+      operations: [SemanticOperation.Update],
+      priority: 90,
+    },
   },
   [SemanticType.DeletedTimestamp]: {
     id: SemanticType.DeletedTimestamp,
@@ -427,6 +533,11 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     category: SemanticCategory.Lifecycle,
     applicableDataTypes: ['datetime'],
     hasConfig: false,
+    runtime: {
+      timing: SemanticTiming.Before,
+      operations: [SemanticOperation.Delete],
+      priority: 80,
+    },
   },
   [SemanticType.DeletedFlag]: {
     id: SemanticType.DeletedFlag,
@@ -436,6 +547,11 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     category: SemanticCategory.Lifecycle,
     applicableDataTypes: ['boolean'],
     hasConfig: false,
+    runtime: {
+      timing: SemanticTiming.Before,
+      operations: [SemanticOperation.Delete, SemanticOperation.Read, SemanticOperation.List],
+      priority: 80,
+    },
   },
   [SemanticType.Version]: {
     id: SemanticType.Version,
@@ -445,6 +561,11 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     category: SemanticCategory.Lifecycle,
     applicableDataTypes: ['number'],
     hasConfig: false,
+    runtime: {
+      timing: SemanticTiming.Before,
+      operations: [SemanticOperation.Update],
+      priority: 85,
+    },
   },
 
   //
@@ -459,6 +580,10 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     category: SemanticCategory.Content,
     applicableDataTypes: ['string'],
     hasConfig: false,
+    runtime: {
+      timing: SemanticTiming.None,
+      operations: [],
+    },
   },
   [SemanticType.Description]: {
     id: SemanticType.Description,
@@ -468,6 +593,10 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     category: SemanticCategory.Content,
     applicableDataTypes: ['string'],
     hasConfig: false,
+    runtime: {
+      timing: SemanticTiming.None,
+      operations: [],
+    },
   },
   [SemanticType.Summary]: {
     id: SemanticType.Summary,
@@ -477,6 +606,10 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     category: SemanticCategory.Content,
     applicableDataTypes: ['string'],
     hasConfig: false,
+    runtime: {
+      timing: SemanticTiming.None,
+      operations: [],
+    },
   },
   [SemanticType.Markdown]: {
     id: SemanticType.Markdown,
@@ -486,6 +619,11 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     category: SemanticCategory.Content,
     applicableDataTypes: ['string'],
     hasConfig: true,
+    runtime: {
+      timing: SemanticTiming.Before,
+      operations: [SemanticOperation.Create, SemanticOperation.Update],
+      priority: 50, // Process before storage
+    },
   },
   [SemanticType.HTML]: {
     id: SemanticType.HTML,
@@ -495,6 +633,11 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     category: SemanticCategory.Content,
     applicableDataTypes: ['string'],
     hasConfig: true,
+    runtime: {
+      timing: SemanticTiming.Before,
+      operations: [SemanticOperation.Create, SemanticOperation.Update],
+      priority: 50, // Process before storage for sanitization
+    },
   },
   [SemanticType.ImageURL]: {
     id: SemanticType.ImageURL,
@@ -504,6 +647,11 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     category: SemanticCategory.Content,
     applicableDataTypes: ['string'],
     hasConfig: false,
+    runtime: {
+      timing: SemanticTiming.Before,
+      operations: [SemanticOperation.Create, SemanticOperation.Update],
+      priority: 60, // Validate URLs before storage
+    },
   },
   [SemanticType.FileURL]: {
     id: SemanticType.FileURL,
@@ -513,6 +661,11 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     category: SemanticCategory.Content,
     applicableDataTypes: ['string'],
     hasConfig: false,
+    runtime: {
+      timing: SemanticTiming.Before,
+      operations: [SemanticOperation.Create, SemanticOperation.Update],
+      priority: 60, // Validate URLs before storage
+    },
   },
 
   //
@@ -527,6 +680,11 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     category: SemanticCategory.Business,
     applicableDataTypes: ['string'],
     hasConfig: true,
+    runtime: {
+      timing: SemanticTiming.Both,
+      operations: [SemanticOperation.Create, SemanticOperation.Update, SemanticOperation.Read, SemanticOperation.List],
+      priority: 30, // Validate state transitions before, filter by state after
+    },
   },
   [SemanticType.Currency]: {
     id: SemanticType.Currency,
@@ -536,6 +694,11 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     category: SemanticCategory.Business,
     applicableDataTypes: ['number', 'string'],
     hasConfig: true,
+    runtime: {
+      timing: SemanticTiming.Before,
+      operations: [SemanticOperation.Create, SemanticOperation.Update],
+      priority: 70, // Validate currency format and precision
+    },
   },
   [SemanticType.SKU]: {
     id: SemanticType.SKU,
@@ -545,6 +708,11 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     category: SemanticCategory.Business,
     applicableDataTypes: ['string'],
     hasConfig: true,
+    runtime: {
+      timing: SemanticTiming.Before,
+      operations: [SemanticOperation.Create, SemanticOperation.Update],
+      priority: 25, // High priority for uniqueness validation
+    },
   },
 
   //
@@ -559,6 +727,11 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     category: SemanticCategory.Contact,
     applicableDataTypes: ['string'],
     hasConfig: true,
+    runtime: {
+      timing: SemanticTiming.Before,
+      operations: [SemanticOperation.Create, SemanticOperation.Update],
+      priority: 40, // Validate email format
+    },
   },
   [SemanticType.Phone]: {
     id: SemanticType.Phone,
@@ -568,6 +741,11 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     category: SemanticCategory.Contact,
     applicableDataTypes: ['string'],
     hasConfig: true,
+    runtime: {
+      timing: SemanticTiming.Before,
+      operations: [SemanticOperation.Create, SemanticOperation.Update],
+      priority: 40, // Validate phone format
+    },
   },
   [SemanticType.URL]: {
     id: SemanticType.URL,
@@ -577,6 +755,11 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     category: SemanticCategory.Contact,
     applicableDataTypes: ['string'],
     hasConfig: true,
+    runtime: {
+      timing: SemanticTiming.Before,
+      operations: [SemanticOperation.Create, SemanticOperation.Update],
+      priority: 40, // Validate URL format
+    },
   },
 
   //
@@ -591,6 +774,11 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     category: SemanticCategory.Organization,
     applicableDataTypes: ['string'],
     hasConfig: true,
+    runtime: {
+      timing: SemanticTiming.Before,
+      operations: [SemanticOperation.Create, SemanticOperation.Update],
+      priority: 30, // Generate slug from title, validate uniqueness
+    },
   },
   [SemanticType.Tags]: {
     id: SemanticType.Tags,
@@ -599,6 +787,11 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     description: 'Enable tagging functionality',
     category: SemanticCategory.Organization,
     hasConfig: true,
+    runtime: {
+      timing: SemanticTiming.After,
+      operations: [SemanticOperation.Create, SemanticOperation.Update, SemanticOperation.Delete],
+      priority: 200, // Process after main operation
+    },
   },
   [SemanticType.Categories]: {
     id: SemanticType.Categories,
@@ -607,6 +800,11 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     description: 'Enable categorization functionality',
     category: SemanticCategory.Organization,
     hasConfig: true,
+    runtime: {
+      timing: SemanticTiming.After,
+      operations: [SemanticOperation.Create, SemanticOperation.Update, SemanticOperation.Delete],
+      priority: 200, // Process after main operation
+    },
   },
 
   //
@@ -621,6 +819,11 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     category: SemanticCategory.Location,
     applicableDataTypes: ['string'],
     hasConfig: true,
+    runtime: {
+      timing: SemanticTiming.Both,
+      operations: [SemanticOperation.Create, SemanticOperation.Update, SemanticOperation.Read, SemanticOperation.List],
+      priority: 60, // Validate coordinates before, enable spatial queries after
+    },
   },
 
   //
@@ -636,6 +839,11 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     category: SemanticCategory.Computed,
     applicableDataTypes: ['string', 'number', 'boolean', 'date', 'datetime', 'time', 'binary'],
     hasConfig: true,
+    runtime: {
+      timing: SemanticTiming.Both,
+      operations: [SemanticOperation.Create, SemanticOperation.Update, SemanticOperation.Read],
+      priority: 150, // Calculate after other validations, recalculate on read if needed
+    },
   },
   [SemanticType.Derived]: {
     id: SemanticType.Derived,
@@ -645,9 +853,55 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     category: SemanticCategory.Computed,
     applicableDataTypes: ['string'],
     hasConfig: true,
+    runtime: {
+      timing: SemanticTiming.After,
+      operations: [SemanticOperation.Create, SemanticOperation.Update],
+      priority: 180, // Derive after all other processing
+    },
   },
 }
 
+/**
+ * Get all semantics that should run for a specific operation and timing
+ */
+export function getSemanticsForOperation(
+  semantics: AppliedDataSemantic[],
+  operation: SemanticOperation,
+  timing: SemanticTiming
+): AppliedDataSemantic[] {
+  return semantics
+    .filter((semantic) => {
+      const definition = DataSemantics[semantic.id]
+      if (!definition?.runtime) {
+        return false
+      }
+
+      const { timing: semanticTiming, operations } = definition.runtime
+
+      // Check if timing matches
+      const timingMatches = semanticTiming === timing || semanticTiming === SemanticTiming.Both
+
+      // Check if operation is included
+      const operationMatches = operations.includes(operation)
+
+      return timingMatches && operationMatches
+    })
+    .sort((a, b) => {
+      // Sort by priority (lower number = higher priority)
+      const priorityA = DataSemantics[a.id]?.runtime?.priority ?? 100
+      const priorityB = DataSemantics[b.id]?.runtime?.priority ?? 100
+      return priorityA - priorityB
+    })
+}
+
+/**
+ * Check if a specific semantic can be disabled at runtime
+ */
+export function canSemanticBeDisabled(semanticType: SemanticType): boolean {
+  const definition = DataSemantics[semanticType]
+  return definition?.runtime?.canDisable !== false // Default to true if not specified
+}
+
 export function getSemanticsByCategory(): Record<SemanticCategory, DataSemantic[]>
 export function getSemanticsByCategory(scope: SemanticScope.Entity): Record<SemanticCategory, EntitySemantic[]>
 export function getSemanticsByCategory(scope: SemanticScope.Property): Record<SemanticCategory, PropertySemantic[]>

package/src/modeling/definitions/Email.ts

@@ -14,10 +14,6 @@ export interface EmailConfig {
    * Whether email verification is required.
    */
   requireVerification?: boolean
-  /**
-   * Method to use for verification: 'email' or 'sms'.
-   */
-  verificationMethod?: 'email' | 'sms'
   /**
    * Whether to allow subaddressing (user+tag@domain.com).
    */
@@ -83,8 +79,7 @@ export const createEmailSemantic = (config: EmailConfig = {}): AppliedEmailSeman
  * Default configuration for Email semantic.
  */
 export const DEFAULT_EMAIL_CONFIG: EmailConfig = {
-  requireVerification: false,
-  verificationMethod: 'email',
+  requireVerification: true,
   allowSubaddressing: true,
   allowInternational: true,
 }