@api-client/core 0.18.23 → 0.18.25

package/build/src/modeling/Semantics.js

@@ -254,6 +254,42 @@ export var SemanticCategory;
      */
     SemanticCategory["Computed"] = "Computed Values";
 })(SemanticCategory || (SemanticCategory = {}));
+/**
+ * Defines when a semantic should execute in relation to database operations.
+ */
+export var SemanticTiming;
+(function (SemanticTiming) {
+    /**
+     * Execute before the database operation (validation, preprocessing)
+     */
+    SemanticTiming["Before"] = "Before";
+    /**
+     * Execute after the database operation (cleanup, notifications, derived values)
+     */
+    SemanticTiming["After"] = "After";
+    /**
+     * Execute both before and after the operation
+     */
+    SemanticTiming["Both"] = "Both";
+    /**
+     * No automatic execution (manual/on-demand only)
+     */
+    SemanticTiming["None"] = "None";
+})(SemanticTiming || (SemanticTiming = {}));
+/**
+ * Defines which database operations can trigger a semantic.
+ */
+export var SemanticOperation;
+(function (SemanticOperation) {
+    SemanticOperation["Create"] = "Create";
+    SemanticOperation["Read"] = "Read";
+    SemanticOperation["Update"] = "Update";
+    SemanticOperation["Delete"] = "Delete";
+    /**
+     * Special operation for list/query operations
+     */
+    SemanticOperation["List"] = "List";
+})(SemanticOperation || (SemanticOperation = {}));
 /**
  * A type guard to check if a semantic is an EntitySemantic.
  */
@@ -281,6 +317,10 @@ export const DataSemantics = {
         description: 'System users and accounts',
         category: SemanticCategory.Identity,
         hasConfig: false,
+        runtime: {
+            timing: SemanticTiming.None,
+            operations: [],
+        },
     },
     [SemanticType.Password]: {
         id: SemanticType.Password,
@@ -290,6 +330,12 @@ export const DataSemantics = {
         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,
@@ -299,6 +345,17 @@ export const DataSemantics = {
         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,
@@ -307,6 +364,18 @@ export const DataSemantics = {
         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,
+        },
     },
     //
     // Timestamps & Versioning
@@ -319,6 +388,11 @@ export const DataSemantics = {
         category: SemanticCategory.Lifecycle,
         applicableDataTypes: ['datetime'],
         hasConfig: false,
+        runtime: {
+            timing: SemanticTiming.Before,
+            operations: [SemanticOperation.Create],
+            priority: 90,
+        },
     },
     [SemanticType.UpdatedTimestamp]: {
         id: SemanticType.UpdatedTimestamp,
@@ -328,6 +402,11 @@ export const DataSemantics = {
         category: SemanticCategory.Lifecycle,
         applicableDataTypes: ['datetime'],
         hasConfig: false,
+        runtime: {
+            timing: SemanticTiming.Before,
+            operations: [SemanticOperation.Update],
+            priority: 90,
+        },
     },
     [SemanticType.DeletedTimestamp]: {
         id: SemanticType.DeletedTimestamp,
@@ -337,6 +416,11 @@ export const DataSemantics = {
         category: SemanticCategory.Lifecycle,
         applicableDataTypes: ['datetime'],
         hasConfig: false,
+        runtime: {
+            timing: SemanticTiming.Before,
+            operations: [SemanticOperation.Delete],
+            priority: 80,
+        },
     },
     [SemanticType.DeletedFlag]: {
         id: SemanticType.DeletedFlag,
@@ -346,6 +430,11 @@ export const DataSemantics = {
         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,
@@ -355,6 +444,11 @@ export const DataSemantics = {
         category: SemanticCategory.Lifecycle,
         applicableDataTypes: ['number'],
         hasConfig: false,
+        runtime: {
+            timing: SemanticTiming.Before,
+            operations: [SemanticOperation.Update],
+            priority: 85,
+        },
     },
     //
     // Content & Media
@@ -367,6 +461,10 @@ export const DataSemantics = {
         category: SemanticCategory.Content,
         applicableDataTypes: ['string'],
         hasConfig: false,
+        runtime: {
+            timing: SemanticTiming.None,
+            operations: [],
+        },
     },
     [SemanticType.Description]: {
         id: SemanticType.Description,
@@ -376,6 +474,10 @@ export const DataSemantics = {
         category: SemanticCategory.Content,
         applicableDataTypes: ['string'],
         hasConfig: false,
+        runtime: {
+            timing: SemanticTiming.None,
+            operations: [],
+        },
     },
     [SemanticType.Summary]: {
         id: SemanticType.Summary,
@@ -385,6 +487,10 @@ export const DataSemantics = {
         category: SemanticCategory.Content,
         applicableDataTypes: ['string'],
         hasConfig: false,
+        runtime: {
+            timing: SemanticTiming.None,
+            operations: [],
+        },
     },
     [SemanticType.Markdown]: {
         id: SemanticType.Markdown,
@@ -394,6 +500,11 @@ export const DataSemantics = {
         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,
@@ -403,6 +514,11 @@ export const DataSemantics = {
         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,
@@ -412,6 +528,11 @@ export const DataSemantics = {
         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,
@@ -421,6 +542,11 @@ export const DataSemantics = {
         category: SemanticCategory.Content,
         applicableDataTypes: ['string'],
         hasConfig: false,
+        runtime: {
+            timing: SemanticTiming.Before,
+            operations: [SemanticOperation.Create, SemanticOperation.Update],
+            priority: 60, // Validate URLs before storage
+        },
     },
     //
     // Business Data
@@ -433,6 +559,11 @@ export const DataSemantics = {
         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,
@@ -442,6 +573,11 @@ export const DataSemantics = {
         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,
@@ -451,6 +587,11 @@ export const DataSemantics = {
         category: SemanticCategory.Business,
         applicableDataTypes: ['string'],
         hasConfig: true,
+        runtime: {
+            timing: SemanticTiming.Before,
+            operations: [SemanticOperation.Create, SemanticOperation.Update],
+            priority: 25, // High priority for uniqueness validation
+        },
     },
     //
     // Contact Information
@@ -463,6 +604,11 @@ export const DataSemantics = {
         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,
@@ -472,6 +618,11 @@ export const DataSemantics = {
         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,
@@ -481,6 +632,11 @@ export const DataSemantics = {
         category: SemanticCategory.Contact,
         applicableDataTypes: ['string'],
         hasConfig: true,
+        runtime: {
+            timing: SemanticTiming.Before,
+            operations: [SemanticOperation.Create, SemanticOperation.Update],
+            priority: 40, // Validate URL format
+        },
     },
     //
     // Classification & Organization
@@ -493,6 +649,11 @@ export const DataSemantics = {
         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,
@@ -501,6 +662,11 @@ export const DataSemantics = {
         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,
@@ -509,6 +675,11 @@ export const DataSemantics = {
         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
+        },
     },
     //
     // Location & Geography
@@ -521,6 +692,11 @@ export const DataSemantics = {
         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
+        },
     },
     //
     // Computed Values
@@ -534,6 +710,11 @@ export const DataSemantics = {
         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,
@@ -543,8 +724,44 @@ export const DataSemantics = {
         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, operation, timing) {
+    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) {
+    const definition = DataSemantics[semanticType];
+    return definition?.runtime?.canDisable !== false; // Default to true if not specified
+}
 /**
  * Helper function to get all semantics grouped by category.
  * Useful for organizing semantics in UI dropdowns and forms.

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

@@ -1 +1 @@
-{"version":3,"file":"Semantics.js","sourceRoot":"","sources":["../../../src/modeling/Semantics.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable no-redeclare */\n/* eslint-disable max-len */\nimport type { DomainPropertyType } from './DataFormat.js'\n\n/**\n * Defines the names for all available data semantics.\n * Using a string enum makes it easy to add or remove semantics in a single place.\n */\nexport enum SemanticType {\n  //\n  // Entity-Level Semantics\n  //\n\n  /**\n   * Designates a Data Entity that represents users of the system.\n   */\n  User = 'Semantic#User',\n\n  //\n  // Property-Level Semantics\n  //\n\n  /**\n   * Annotates the field as the user password.\n   * The runtime should treat this field with special care,\n   * ensuring it is encrypted and not exposed in API responses.\n   */\n  Password = 'Semantic#Password',\n  /**\n   * Designates a Data Property as the `createdAt` timestamp of an entity.\n   * This is used to track when the entity was first created.\n   */\n  CreatedTimestamp = 'Semantic#CreatedTimestamp',\n  /**\n   * Designates a Data Property as the `updatedAt` timestamp of an entity.\n   * This is used to track when the entity was last modified.\n   */\n  UpdatedTimestamp = 'Semantic#UpdatedTimestamp',\n  /**\n   * Designates a Data Property as the `deletedAt` timestamp of an entity.\n   * This is used to track when the entity was soft-deleted.\n   * Soft-deletion means the entity is not physically removed from the database,\n   * but marked as deleted for logical deletion purposes.\n   */\n  DeletedTimestamp = 'Semantic#DeletedTimestamp',\n  /**\n   * Designates a Data Property as a boolean flag indicating whether the entity is deleted.\n   * This is used for soft-deletion, where the entity is not physically removed from the database,\n   * but marked as deleted.\n   */\n  DeletedFlag = 'Semantic#DeletedFlag',\n  /**\n   * Designates a Data Property as a public identifier for a resource (the slug).\n   * This is often used in URLs to provide a user-friendly way to access the resource.\n   * For example, a blog post might have a public unique name like \"my-first-post\".\n   * The runtime automatically generates a URL-safe string from another field (like a title).\n   * By default, slugs are generated to be unique, but the configuration allows for duplicates\n   * in scenarios where uniqueness is handled by a combination of fields (e.g., year and slug).\n   */\n  PublicUniqueName = 'Semantic#PublicUniqueName',\n  /**\n   * A semantic that describes a title of an article, blog post, and so on. This semantic is used with\n   * the `PublicUniqueName` to determine which field is responsible for the slug generation. However,\n   * we may add more automation related to the `title` property in the future.\n   */\n  Title = 'Semantic#Title',\n  /**\n   * Designates a Data Property as the `role` of a user within the system.\n   * This is used to define the user's permissions and access levels.\n   * For example, a user with the role of \"admin\" would have elevated permissions\n   * compared to a user with the role of \"guest\".\n   * Roles are defined on the entity as enums, or as a string property with a controlled vocabulary.\n   */\n  UserRole = 'Semantic#UserRole',\n  /**\n   * A text or enum field to represent the state of a record (e.g., `draft`, `published`, `pending_review`, `archived`).\n   *\n   * Defined behaviors:\n   * - State-Based Filtering: Automatically prevents public users from seeing records in a draft state.\n   * - State Transitions: In principle, the runtime should prevent the user from skipping some states.\n   * For example, when the record is in the `draft` state, it cannot be moved to the `archived` state without publishing it first. However,\n   * we do not have enough customer feedback to design this functionality correctly right now, so\n   * it serves as a placeholder semantic annotation.\n   */\n  Status = 'Semantic#Status',\n\n  /**\n   * Annotates an integer field that automatically increments.\n   * The runtime automatically increments this number on every update, providing a simple way\n   * to track changes and implement optimistic locking to prevent mid-air collisions.\n   */\n  Version = 'Semantic#Version',\n\n  /**\n   * Annotates a field that holds a reference to an image data via an URL.\n   * The application + runtime should validate that the input is a well-formed URL.\n   */\n  ImageURL = 'Semantic#ImageURL',\n\n  /**\n   * Annotates a field that holds a reference to a file object via an URL. Ity is distinct from the\n   * `ImageURL` semantic as it implicitly states that the target is non-image, binary data (an attachment, for example).\n   */\n  FileURL = 'Semantic#FileURL',\n\n  /**\n   * Annotates the field as a markdown-interpreted field.\n   * When an object is created, the runtime performs additional sanitization to prevent XSS attacks.\n   *\n   * The annotation describes whether the data should be translated to the HTML output when\n   * record is read or the original MD content should be returned.\n   */\n  Markdown = 'Semantic#Markdown',\n\n  /**\n   * Annotates the field as containing HTML content.\n   * The runtime performs sanitization to prevent XSS attacks and validates HTML structure.\n   *\n   * The annotation describes whether the data should be rendered as HTML output when\n   * record is read or the original HTML content should be returned.\n   */\n  HTML = 'Semantic#HTML',\n\n  /**\n   * Annotates a field that holds geospatial coordinate data (latitude/longitude).\n   * The runtime automatically generates API capabilities for location-based queries,\n   * such as \"find all restaurants within a 5-mile radius.\"\n   *\n   * The field should contain coordinate data in a standard format:\n   * - \"40.7128,-74.0060\" (lat,lon)\n   * - \"POINT(-74.0060 40.7128)\" (PostGIS format)\n   * - \"40.7128°N, 74.0060°W\" (degree format)\n   *\n   * Defined behaviors:\n   * - Spatial Indexing: The runtime automatically creates spatial indexes for efficient location-based queries\n   * - Distance Queries: Enables API endpoints for finding records within specified distances\n   * - Coordinate Validation: Validates that the input follows proper coordinate format\n   * - PostGIS Integration: When using PostgreSQL, automatically maps to PostGIS geometry types\n   */\n  GeospatialCoordinates = 'Semantic#GeospatialCoordinates',\n\n  /**\n   * Annotates a field as an email address with validation and verification options.\n   */\n  Email = 'Semantic#Email',\n  /**\n   * Annotates a field as a phone number with validation and formatting options.\n   */\n  Phone = 'Semantic#Phone',\n  /**\n   * Annotates a field as a monetary value with currency support and precision control.\n   * Can store simple decimal amounts or complex objects with amount and currency.\n   *\n   * As a semantic, it provides flexibility by annotating a base `number` or `string` type,\n   * allowing for different storage strategies (e.g., decimal, integer cents, or a JSON object)\n   * while maintaining a consistent API for currency operations.\n   */\n  Currency = 'Semantic#Currency',\n  /**\n   * Annotates a field as a URL with validation and allowed protocols.\n   */\n  URL = 'Semantic#URL',\n  /**\n   * Annotates a field as a Stock Keeping Unit (SKU).\n   * Enforces uniqueness at the database level, critical for product catalogs.\n   * Provides automatic validation and formatting for product identification codes.\n   */\n  SKU = 'Semantic#SKU',\n  /**\n   * Annotates a field as a long-form description.\n   */\n  Description = 'Semantic#Description',\n  /**\n   * Annotates a field as a short summary.\n   */\n  Summary = 'Semantic#Summary',\n  /**\n   * Annotates a field as a calculated value based on a formula.\n   */\n  Calculated = 'Semantic#Calculated',\n  /**\n   * Annotates a field as derived from other fields.\n   */\n  Derived = 'Semantic#Derived',\n\n  //\n  // Association-Level Semantics\n  //\n\n  /**\n   * Designates an association that links a resource to a \"User\" entity instance.\n   * This is used to indicate ownership of the resource for access control purposes.\n   * For example, a blog post might have a resource owner identifier that points to the user who created it.\n   *\n   * Defined behaviors:\n   * - Automatic Ownership: When a new record is created, this field is automatically populated with the ID of the authenticated user. It also creates a foreign relationship to the `User` semantic object.\n   * - Scoped Access: The runtime automatically filters list and read operations to show only records where the Owner matches the current user. update and delete operations are similarly restricted.\n   */\n  ResourceOwnerIdentifier = 'Semantic#ResourceOwnerIdentifier',\n  /**\n   * Annotates an association as supporting tag functionality.\n   * Applied to associations between entities to enable tagging behavior.\n   * For example, a Product-Category association with Tags semantic enables product tagging.\n   */\n  Tags = 'Semantic#Tags',\n  /**\n   * Annotates an association as supporting category functionality.\n   * Applied to associations between entities to enable categorization behavior.\n   * For example, a Product-Category association with Categories semantic enables product categorization.\n   */\n  Categories = 'Semantic#Categories',\n}\n\n/**\n * Defines the scope at which a semantic can be applied.\n */\nexport enum SemanticScope {\n  /**\n   * The semantic applies to an entire Data Entity.\n   * This is used for semantics that provide context or constraints at the entity level.\n   */\n  Entity = 'Entity',\n  /**\n   * The semantic applies to a single Data Property.\n   * This is used for semantics that provide context or constraints at the property level.\n   */\n  Property = 'Property',\n  /**\n   * The semantic applies to an Association between Data Entities.\n   * This is used for semantics that provide context or constraints at the association level.\n   */\n  Association = 'Association',\n}\n\n/**\n * Defines categories for organizing semantics in the UI.\n */\nexport enum SemanticCategory {\n  /**\n   * User management, authentication, and access control\n   */\n  Identity = 'Identity & Authentication',\n  /**\n   * Timestamps, versioning, and record lifecycle\n   */\n  Lifecycle = 'Timestamps & Versioning',\n  /**\n   * Text content, media, and rich content types\n   */\n  Content = 'Content & Media',\n  /**\n   * Business-specific data like pricing, inventory, status\n   */\n  Business = 'Business Data',\n  /**\n   * Contact information and communication\n   */\n  Contact = 'Contact Information',\n  /**\n   * Organization, categorization, and tagging\n   */\n  Organization = 'Classification & Organization',\n  /**\n   * Location and geographical data\n   */\n  Location = 'Location & Geography',\n  /**\n   * Calculated and derived values\n   */\n  Computed = 'Computed Values',\n}\n\n/**\n * A base interface for all Data Semantics, containing common properties.\n * A semantic is an annotation applied to a Data Entity, Property, or Association\n * to provide additional context or constraints.\n * This interface is extended by more specific semantic types.\n */\ninterface BaseDataSemantic {\n  /**\n   * A unique identifier for the semantic definition.\n   */\n  id: SemanticType\n  /**\n   * A human-readable name for the semantic.\n   */\n  displayName: string\n  /**\n   * A description of the semantic's purpose and impact.\n   */\n  description: string\n  /**\n   * Specifies whether the semantic applies to an Entity, Property, or Association.\n   */\n  scope: SemanticScope\n  /**\n   * The category this semantic belongs to for UI organization.\n   */\n  category: SemanticCategory\n  /**\n   * Whether the semantic has a configuration or additional options.\n   * This is used to determine if the semantic requires additional setup or configuration.\n   */\n  hasConfig: boolean\n}\n\n/**\n * Represents a semantic that can be applied to an entire Data Entity.\n */\nexport interface EntitySemantic extends BaseDataSemantic {\n  scope: SemanticScope.Entity\n}\n\n/**\n * Represents a semantic that can be applied to a single property.\n */\nexport interface PropertySemantic extends BaseDataSemantic {\n  scope: SemanticScope.Property\n  /**\n   * Optional array of data types this semantic can be applied to.\n   * Enforces constraints, e.g., DeletedTimestamp on a DateTime property.\n   */\n  applicableDataTypes?: DomainPropertyType[]\n}\n\n/**\n * Represents a semantic that can be applied to an association between entities.\n */\nexport interface AssociationSemantic extends BaseDataSemantic {\n  scope: SemanticScope.Association\n}\n\n/**\n * A type guard to check if a semantic is an EntitySemantic.\n */\nexport const isEntitySemantic = (semantic: DataSemantic): semantic is EntitySemantic =>\n  semantic.scope === SemanticScope.Entity\n\n/**\n * A type guard to check if a semantic is a PropertySemantic.\n */\nexport const isPropertySemantic = (semantic: DataSemantic): semantic is PropertySemantic =>\n  semantic.scope === SemanticScope.Property\n\n/**\n * A type guard to check if a semantic is a AssociationSemantic.\n */\nexport const isAssociationSemantic = (semantic: DataSemantic): semantic is AssociationSemantic =>\n  semantic.scope === SemanticScope.Association\n\n/**\n * Union type for any kind of data semantic\n */\nexport type DataSemantic = EntitySemantic | PropertySemantic | AssociationSemantic\n\n/**\n * A map to store the definitions of all available data semantics.\n * This acts as a central registry for the application.\n */\nexport const DataSemantics: Record<SemanticType, DataSemantic> = {\n  //\n  // Identity & Authentication\n  //\n\n  [SemanticType.User]: {\n    id: SemanticType.User,\n    displayName: 'User Entity',\n    scope: SemanticScope.Entity,\n    description: 'System users and accounts',\n    category: SemanticCategory.Identity,\n    hasConfig: false,\n  },\n  [SemanticType.Password]: {\n    id: SemanticType.Password,\n    displayName: 'User Password',\n    scope: SemanticScope.Property,\n    description: 'Secure password field',\n    category: SemanticCategory.Identity,\n    applicableDataTypes: ['string'],\n    hasConfig: true,\n  },\n  [SemanticType.UserRole]: {\n    id: SemanticType.UserRole,\n    displayName: 'User Role Field',\n    scope: SemanticScope.Property,\n    description: 'User permissions and access level',\n    category: SemanticCategory.Identity,\n    applicableDataTypes: ['string'],\n    hasConfig: false,\n  },\n  [SemanticType.ResourceOwnerIdentifier]: {\n    id: SemanticType.ResourceOwnerIdentifier,\n    displayName: 'Resource Owner Identifier',\n    scope: SemanticScope.Association,\n    description: 'Links record to owner user',\n    category: SemanticCategory.Identity,\n    hasConfig: false,\n  },\n\n  //\n  // Timestamps & Versioning\n  //\n\n  [SemanticType.CreatedTimestamp]: {\n    id: SemanticType.CreatedTimestamp,\n    displayName: 'Creation Timestamp',\n    scope: SemanticScope.Property,\n    description: 'When record was created',\n    category: SemanticCategory.Lifecycle,\n    applicableDataTypes: ['datetime'],\n    hasConfig: false,\n  },\n  [SemanticType.UpdatedTimestamp]: {\n    id: SemanticType.UpdatedTimestamp,\n    displayName: 'Update Timestamp',\n    scope: SemanticScope.Property,\n    description: 'When record was last modified',\n    category: SemanticCategory.Lifecycle,\n    applicableDataTypes: ['datetime'],\n    hasConfig: false,\n  },\n  [SemanticType.DeletedTimestamp]: {\n    id: SemanticType.DeletedTimestamp,\n    displayName: 'Soft Delete Timestamp',\n    scope: SemanticScope.Property,\n    description: 'When record was marked deleted',\n    category: SemanticCategory.Lifecycle,\n    applicableDataTypes: ['datetime'],\n    hasConfig: false,\n  },\n  [SemanticType.DeletedFlag]: {\n    id: SemanticType.DeletedFlag,\n    displayName: 'Soft Delete Flag',\n    scope: SemanticScope.Property,\n    description: 'Mark record as deleted',\n    category: SemanticCategory.Lifecycle,\n    applicableDataTypes: ['boolean'],\n    hasConfig: false,\n  },\n  [SemanticType.Version]: {\n    id: SemanticType.Version,\n    displayName: 'Version Number',\n    scope: SemanticScope.Property,\n    description: 'Auto-incrementing version counter',\n    category: SemanticCategory.Lifecycle,\n    applicableDataTypes: ['number'],\n    hasConfig: false,\n  },\n\n  //\n  // Content & Media\n  //\n\n  [SemanticType.Title]: {\n    id: SemanticType.Title,\n    displayName: 'Record Title',\n    scope: SemanticScope.Property,\n    description: 'Main title or heading',\n    category: SemanticCategory.Content,\n    applicableDataTypes: ['string'],\n    hasConfig: false,\n  },\n  [SemanticType.Description]: {\n    id: SemanticType.Description,\n    displayName: 'Description',\n    scope: SemanticScope.Property,\n    description: 'Detailed description text',\n    category: SemanticCategory.Content,\n    applicableDataTypes: ['string'],\n    hasConfig: false,\n  },\n  [SemanticType.Summary]: {\n    id: SemanticType.Summary,\n    displayName: 'Summary',\n    scope: SemanticScope.Property,\n    description: 'Brief summary text',\n    category: SemanticCategory.Content,\n    applicableDataTypes: ['string'],\n    hasConfig: false,\n  },\n  [SemanticType.Markdown]: {\n    id: SemanticType.Markdown,\n    displayName: 'Markdown Content',\n    scope: SemanticScope.Property,\n    description: 'Formatted text content',\n    category: SemanticCategory.Content,\n    applicableDataTypes: ['string'],\n    hasConfig: true,\n  },\n  [SemanticType.HTML]: {\n    id: SemanticType.HTML,\n    displayName: 'HTML Content',\n    scope: SemanticScope.Property,\n    description: 'Rich HTML content',\n    category: SemanticCategory.Content,\n    applicableDataTypes: ['string'],\n    hasConfig: true,\n  },\n  [SemanticType.ImageURL]: {\n    id: SemanticType.ImageURL,\n    displayName: 'Image URL',\n    scope: SemanticScope.Property,\n    description: 'Link to image file',\n    category: SemanticCategory.Content,\n    applicableDataTypes: ['string'],\n    hasConfig: false,\n  },\n  [SemanticType.FileURL]: {\n    id: SemanticType.FileURL,\n    displayName: 'File URL',\n    scope: SemanticScope.Property,\n    description: 'Link to file attachment',\n    category: SemanticCategory.Content,\n    applicableDataTypes: ['string'],\n    hasConfig: false,\n  },\n\n  //\n  // Business Data\n  //\n\n  [SemanticType.Status]: {\n    id: SemanticType.Status,\n    displayName: 'Record Status',\n    scope: SemanticScope.Property,\n    description: 'Current state of record',\n    category: SemanticCategory.Business,\n    applicableDataTypes: ['string'],\n    hasConfig: true,\n  },\n  [SemanticType.Currency]: {\n    id: SemanticType.Currency,\n    displayName: 'Currency',\n    scope: SemanticScope.Property,\n    description: 'Monetary value with currency',\n    category: SemanticCategory.Business,\n    applicableDataTypes: ['number', 'string'],\n    hasConfig: true,\n  },\n  [SemanticType.SKU]: {\n    id: SemanticType.SKU,\n    displayName: 'SKU',\n    scope: SemanticScope.Property,\n    description: 'Product identification code',\n    category: SemanticCategory.Business,\n    applicableDataTypes: ['string'],\n    hasConfig: true,\n  },\n\n  //\n  // Contact Information\n  //\n\n  [SemanticType.Email]: {\n    id: SemanticType.Email,\n    displayName: 'Email',\n    scope: SemanticScope.Property,\n    description: 'Email address',\n    category: SemanticCategory.Contact,\n    applicableDataTypes: ['string'],\n    hasConfig: true,\n  },\n  [SemanticType.Phone]: {\n    id: SemanticType.Phone,\n    displayName: 'Phone',\n    scope: SemanticScope.Property,\n    description: 'Phone number',\n    category: SemanticCategory.Contact,\n    applicableDataTypes: ['string'],\n    hasConfig: true,\n  },\n  [SemanticType.URL]: {\n    id: SemanticType.URL,\n    displayName: 'URL',\n    scope: SemanticScope.Property,\n    description: 'Web address or link',\n    category: SemanticCategory.Contact,\n    applicableDataTypes: ['string'],\n    hasConfig: true,\n  },\n\n  //\n  // Classification & Organization\n  //\n\n  [SemanticType.PublicUniqueName]: {\n    id: SemanticType.PublicUniqueName,\n    displayName: 'Public Unique Name (Slug)',\n    scope: SemanticScope.Property,\n    description: 'URL-friendly unique identifier',\n    category: SemanticCategory.Organization,\n    applicableDataTypes: ['string'],\n    hasConfig: true,\n  },\n  [SemanticType.Tags]: {\n    id: SemanticType.Tags,\n    displayName: 'Tags',\n    scope: SemanticScope.Association,\n    description: 'Enable tagging functionality',\n    category: SemanticCategory.Organization,\n    hasConfig: true,\n  },\n  [SemanticType.Categories]: {\n    id: SemanticType.Categories,\n    displayName: 'Categories',\n    scope: SemanticScope.Association,\n    description: 'Enable categorization functionality',\n    category: SemanticCategory.Organization,\n    hasConfig: true,\n  },\n\n  //\n  // Location & Geography\n  //\n\n  [SemanticType.GeospatialCoordinates]: {\n    id: SemanticType.GeospatialCoordinates,\n    displayName: 'Geospatial Coordinates',\n    scope: SemanticScope.Property,\n    description: 'Location coordinates',\n    category: SemanticCategory.Location,\n    applicableDataTypes: ['string'],\n    hasConfig: true,\n  },\n\n  //\n  // Computed Values\n  //\n\n  // Calculated field can be added to any data type as we can compute any value.\n  [SemanticType.Calculated]: {\n    id: SemanticType.Calculated,\n    displayName: 'Calculated',\n    scope: SemanticScope.Property,\n    description: 'Auto-calculated field value',\n    category: SemanticCategory.Computed,\n    applicableDataTypes: ['string', 'number', 'boolean', 'date', 'datetime', 'time', 'binary'],\n    hasConfig: true,\n  },\n  [SemanticType.Derived]: {\n    id: SemanticType.Derived,\n    displayName: 'Derived',\n    scope: SemanticScope.Property,\n    description: 'Value derived from other fields',\n    category: SemanticCategory.Computed,\n    applicableDataTypes: ['string'],\n    hasConfig: true,\n  },\n}\n\nexport function getSemanticsByCategory(): Record<SemanticCategory, DataSemantic[]>\nexport function getSemanticsByCategory(scope: SemanticScope.Entity): Record<SemanticCategory, EntitySemantic[]>\nexport function getSemanticsByCategory(scope: SemanticScope.Property): Record<SemanticCategory, PropertySemantic[]>\nexport function getSemanticsByCategory(\n  scope: SemanticScope.Association\n): Record<SemanticCategory, AssociationSemantic[]>\n\n/**\n * Helper function to get all semantics grouped by category.\n * Useful for organizing semantics in UI dropdowns and forms.\n *\n * @param scope Optional scope to filter semantics by (Entity, Property, Association)\n */\nexport function getSemanticsByCategory(scope?: SemanticScope): Record<SemanticCategory, DataSemantic[]> {\n  const result: Record<SemanticCategory, DataSemantic[]> = {\n    [SemanticCategory.Identity]: [],\n    [SemanticCategory.Lifecycle]: [],\n    [SemanticCategory.Content]: [],\n    [SemanticCategory.Business]: [],\n    [SemanticCategory.Contact]: [],\n    [SemanticCategory.Organization]: [],\n    [SemanticCategory.Location]: [],\n    [SemanticCategory.Computed]: [],\n  }\n\n  Object.values(DataSemantics).forEach((semantic) => {\n    // If a scope is provided, filter semantics by that scope\n    if (scope && semantic.scope !== scope) {\n      return\n    }\n    result[semantic.category].push(semantic)\n  })\n\n  return result\n}\n\n/**\n * Helper function to get semantics for a specific category.\n * @param category The category to filter by\n * @returns Array of semantics in the specified category\n */\nexport const getSemanticsByCategoryType = (category: SemanticCategory): DataSemantic[] => {\n  return Object.values(DataSemantics).filter((semantic) => semantic.category === category)\n}\n\n/**\n * Represents the application of a data semantic to a specific\n * entity or property within a user's data model.\n */\nexport interface AppliedDataSemantic {\n  /**\n   * The unique identifier of the semantic being applied.\n   */\n  id: SemanticType\n\n  /**\n   * Optional configuration or values specific to this application.\n   */\n  config?: Record<string, unknown>\n}\n"]}
+{"version":3,"file":"Semantics.js","sourceRoot":"","sources":["../../../src/modeling/Semantics.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable no-redeclare */\n/* eslint-disable max-len */\nimport type { DomainPropertyType } from './DataFormat.js'\n\n/**\n * Defines the names for all available data semantics.\n * Using a string enum makes it easy to add or remove semantics in a single place.\n */\nexport enum SemanticType {\n  //\n  // Entity-Level Semantics\n  //\n\n  /**\n   * Designates a Data Entity that represents users of the system.\n   */\n  User = 'Semantic#User',\n\n  //\n  // Property-Level Semantics\n  //\n\n  /**\n   * Annotates the field as the user password.\n   * The runtime should treat this field with special care,\n   * ensuring it is encrypted and not exposed in API responses.\n   */\n  Password = 'Semantic#Password',\n  /**\n   * Designates a Data Property as the `createdAt` timestamp of an entity.\n   * This is used to track when the entity was first created.\n   */\n  CreatedTimestamp = 'Semantic#CreatedTimestamp',\n  /**\n   * Designates a Data Property as the `updatedAt` timestamp of an entity.\n   * This is used to track when the entity was last modified.\n   */\n  UpdatedTimestamp = 'Semantic#UpdatedTimestamp',\n  /**\n   * Designates a Data Property as the `deletedAt` timestamp of an entity.\n   * This is used to track when the entity was soft-deleted.\n   * Soft-deletion means the entity is not physically removed from the database,\n   * but marked as deleted for logical deletion purposes.\n   */\n  DeletedTimestamp = 'Semantic#DeletedTimestamp',\n  /**\n   * Designates a Data Property as a boolean flag indicating whether the entity is deleted.\n   * This is used for soft-deletion, where the entity is not physically removed from the database,\n   * but marked as deleted.\n   */\n  DeletedFlag = 'Semantic#DeletedFlag',\n  /**\n   * Designates a Data Property as a public identifier for a resource (the slug).\n   * This is often used in URLs to provide a user-friendly way to access the resource.\n   * For example, a blog post might have a public unique name like \"my-first-post\".\n   * The runtime automatically generates a URL-safe string from another field (like a title).\n   * By default, slugs are generated to be unique, but the configuration allows for duplicates\n   * in scenarios where uniqueness is handled by a combination of fields (e.g., year and slug).\n   */\n  PublicUniqueName = 'Semantic#PublicUniqueName',\n  /**\n   * A semantic that describes a title of an article, blog post, and so on. This semantic is used with\n   * the `PublicUniqueName` to determine which field is responsible for the slug generation. However,\n   * we may add more automation related to the `title` property in the future.\n   */\n  Title = 'Semantic#Title',\n  /**\n   * Designates a Data Property as the `role` of a user within the system.\n   * This is used to define the user's permissions and access levels.\n   * For example, a user with the role of \"admin\" would have elevated permissions\n   * compared to a user with the role of \"guest\".\n   * Roles are defined on the entity as enums, or as a string property with a controlled vocabulary.\n   */\n  UserRole = 'Semantic#UserRole',\n  /**\n   * A text or enum field to represent the state of a record (e.g., `draft`, `published`, `pending_review`, `archived`).\n   *\n   * Defined behaviors:\n   * - State-Based Filtering: Automatically prevents public users from seeing records in a draft state.\n   * - State Transitions: In principle, the runtime should prevent the user from skipping some states.\n   * For example, when the record is in the `draft` state, it cannot be moved to the `archived` state without publishing it first. However,\n   * we do not have enough customer feedback to design this functionality correctly right now, so\n   * it serves as a placeholder semantic annotation.\n   */\n  Status = 'Semantic#Status',\n\n  /**\n   * Annotates an integer field that automatically increments.\n   * The runtime automatically increments this number on every update, providing a simple way\n   * to track changes and implement optimistic locking to prevent mid-air collisions.\n   */\n  Version = 'Semantic#Version',\n\n  /**\n   * Annotates a field that holds a reference to an image data via an URL.\n   * The application + runtime should validate that the input is a well-formed URL.\n   */\n  ImageURL = 'Semantic#ImageURL',\n\n  /**\n   * Annotates a field that holds a reference to a file object via an URL. Ity is distinct from the\n   * `ImageURL` semantic as it implicitly states that the target is non-image, binary data (an attachment, for example).\n   */\n  FileURL = 'Semantic#FileURL',\n\n  /**\n   * Annotates the field as a markdown-interpreted field.\n   * When an object is created, the runtime performs additional sanitization to prevent XSS attacks.\n   *\n   * The annotation describes whether the data should be translated to the HTML output when\n   * record is read or the original MD content should be returned.\n   */\n  Markdown = 'Semantic#Markdown',\n\n  /**\n   * Annotates the field as containing HTML content.\n   * The runtime performs sanitization to prevent XSS attacks and validates HTML structure.\n   *\n   * The annotation describes whether the data should be rendered as HTML output when\n   * record is read or the original HTML content should be returned.\n   */\n  HTML = 'Semantic#HTML',\n\n  /**\n   * Annotates a field that holds geospatial coordinate data (latitude/longitude).\n   * The runtime automatically generates API capabilities for location-based queries,\n   * such as \"find all restaurants within a 5-mile radius.\"\n   *\n   * The field should contain coordinate data in a standard format:\n   * - \"40.7128,-74.0060\" (lat,lon)\n   * - \"POINT(-74.0060 40.7128)\" (PostGIS format)\n   * - \"40.7128°N, 74.0060°W\" (degree format)\n   *\n   * Defined behaviors:\n   * - Spatial Indexing: The runtime automatically creates spatial indexes for efficient location-based queries\n   * - Distance Queries: Enables API endpoints for finding records within specified distances\n   * - Coordinate Validation: Validates that the input follows proper coordinate format\n   * - PostGIS Integration: When using PostgreSQL, automatically maps to PostGIS geometry types\n   */\n  GeospatialCoordinates = 'Semantic#GeospatialCoordinates',\n\n  /**\n   * Annotates a field as an email address with validation and verification options.\n   */\n  Email = 'Semantic#Email',\n  /**\n   * Annotates a field as a phone number with validation and formatting options.\n   */\n  Phone = 'Semantic#Phone',\n  /**\n   * Annotates a field as a monetary value with currency support and precision control.\n   * Can store simple decimal amounts or complex objects with amount and currency.\n   *\n   * As a semantic, it provides flexibility by annotating a base `number` or `string` type,\n   * allowing for different storage strategies (e.g., decimal, integer cents, or a JSON object)\n   * while maintaining a consistent API for currency operations.\n   */\n  Currency = 'Semantic#Currency',\n  /**\n   * Annotates a field as a URL with validation and allowed protocols.\n   */\n  URL = 'Semantic#URL',\n  /**\n   * Annotates a field as a Stock Keeping Unit (SKU).\n   * Enforces uniqueness at the database level, critical for product catalogs.\n   * Provides automatic validation and formatting for product identification codes.\n   */\n  SKU = 'Semantic#SKU',\n  /**\n   * Annotates a field as a long-form description.\n   */\n  Description = 'Semantic#Description',\n  /**\n   * Annotates a field as a short summary.\n   */\n  Summary = 'Semantic#Summary',\n  /**\n   * Annotates a field as a calculated value based on a formula.\n   */\n  Calculated = 'Semantic#Calculated',\n  /**\n   * Annotates a field as derived from other fields.\n   */\n  Derived = 'Semantic#Derived',\n\n  //\n  // Association-Level Semantics\n  //\n\n  /**\n   * Designates an association that links a resource to a \"User\" entity instance.\n   * This is used to indicate ownership of the resource for access control purposes.\n   * For example, a blog post might have a resource owner identifier that points to the user who created it.\n   *\n   * Defined behaviors:\n   * - Automatic Ownership: When a new record is created, this field is automatically populated with the ID of the authenticated user. It also creates a foreign relationship to the `User` semantic object.\n   * - Scoped Access: The runtime automatically filters list and read operations to show only records where the Owner matches the current user. update and delete operations are similarly restricted.\n   */\n  ResourceOwnerIdentifier = 'Semantic#ResourceOwnerIdentifier',\n  /**\n   * Annotates an association as supporting tag functionality.\n   * Applied to associations between entities to enable tagging behavior.\n   * For example, a Product-Category association with Tags semantic enables product tagging.\n   */\n  Tags = 'Semantic#Tags',\n  /**\n   * Annotates an association as supporting category functionality.\n   * Applied to associations between entities to enable categorization behavior.\n   * For example, a Product-Category association with Categories semantic enables product categorization.\n   */\n  Categories = 'Semantic#Categories',\n}\n\n/**\n * Defines the scope at which a semantic can be applied.\n */\nexport enum SemanticScope {\n  /**\n   * The semantic applies to an entire Data Entity.\n   * This is used for semantics that provide context or constraints at the entity level.\n   */\n  Entity = 'Entity',\n  /**\n   * The semantic applies to a single Data Property.\n   * This is used for semantics that provide context or constraints at the property level.\n   */\n  Property = 'Property',\n  /**\n   * The semantic applies to an Association between Data Entities.\n   * This is used for semantics that provide context or constraints at the association level.\n   */\n  Association = 'Association',\n}\n\n/**\n * Defines categories for organizing semantics in the UI.\n */\nexport enum SemanticCategory {\n  /**\n   * User management, authentication, and access control\n   */\n  Identity = 'Identity & Authentication',\n  /**\n   * Timestamps, versioning, and record lifecycle\n   */\n  Lifecycle = 'Timestamps & Versioning',\n  /**\n   * Text content, media, and rich content types\n   */\n  Content = 'Content & Media',\n  /**\n   * Business-specific data like pricing, inventory, status\n   */\n  Business = 'Business Data',\n  /**\n   * Contact information and communication\n   */\n  Contact = 'Contact Information',\n  /**\n   * Organization, categorization, and tagging\n   */\n  Organization = 'Classification & Organization',\n  /**\n   * Location and geographical data\n   */\n  Location = 'Location & Geography',\n  /**\n   * Calculated and derived values\n   */\n  Computed = 'Computed Values',\n}\n\n/**\n * Defines when a semantic should execute in relation to database operations.\n */\nexport enum SemanticTiming {\n  /**\n   * Execute before the database operation (validation, preprocessing)\n   */\n  Before = 'Before',\n  /**\n   * Execute after the database operation (cleanup, notifications, derived values)\n   */\n  After = 'After',\n  /**\n   * Execute both before and after the operation\n   */\n  Both = 'Both',\n  /**\n   * No automatic execution (manual/on-demand only)\n   */\n  None = 'None',\n}\n\n/**\n * Defines which database operations can trigger a semantic.\n */\nexport enum SemanticOperation {\n  Create = 'Create',\n  Read = 'Read',\n  Update = 'Update',\n  Delete = 'Delete',\n  /**\n   * Special operation for list/query operations\n   */\n  List = 'List',\n}\n\n/**\n * Configuration for when and how a semantic should execute at runtime.\n */\nexport interface SemanticRuntimeConfig {\n  /**\n   * When the semantic should execute relative to the database operation.\n   */\n  timing: SemanticTiming\n  /**\n   * Which database operations should trigger this semantic.\n   */\n  operations: SemanticOperation[]\n  /**\n   * Priority order for execution when multiple semantics apply.\n   * Lower numbers execute first. Default is 100.\n   */\n  priority?: number\n  /**\n   * Whether this semantic can be disabled at the entity/property level.\n   */\n  canDisable?: boolean\n}\n\n/**\n * A base interface for all Data Semantics, containing common properties.\n * A semantic is an annotation applied to a Data Entity, Property, or Association\n * to provide additional context or constraints.\n * This interface is extended by more specific semantic types.\n */\ninterface BaseDataSemantic {\n  /**\n   * A unique identifier for the semantic definition.\n   */\n  id: SemanticType\n  /**\n   * A human-readable name for the semantic.\n   */\n  displayName: string\n  /**\n   * A description of the semantic's purpose and impact.\n   */\n  description: string\n  /**\n   * Specifies whether the semantic applies to an Entity, Property, or Association.\n   */\n  scope: SemanticScope\n  /**\n   * The category this semantic belongs to for UI organization.\n   */\n  category: SemanticCategory\n  /**\n   * Whether the semantic has a configuration or additional options.\n   * This is used to determine if the semantic requires additional setup or configuration.\n   */\n  hasConfig: boolean\n  /**\n   * Runtime execution configuration for this semantic.\n   */\n  runtime: SemanticRuntimeConfig\n}\n\n/**\n * Represents a semantic that can be applied to an entire Data Entity.\n */\nexport interface EntitySemantic extends BaseDataSemantic {\n  scope: SemanticScope.Entity\n}\n\n/**\n * Represents a semantic that can be applied to a single property.\n */\nexport interface PropertySemantic extends BaseDataSemantic {\n  scope: SemanticScope.Property\n  /**\n   * Optional array of data types this semantic can be applied to.\n   * Enforces constraints, e.g., DeletedTimestamp on a DateTime property.\n   */\n  applicableDataTypes?: DomainPropertyType[]\n}\n\n/**\n * Represents a semantic that can be applied to an association between entities.\n */\nexport interface AssociationSemantic extends BaseDataSemantic {\n  scope: SemanticScope.Association\n}\n\n/**\n * A type guard to check if a semantic is an EntitySemantic.\n */\nexport const isEntitySemantic = (semantic: DataSemantic): semantic is EntitySemantic =>\n  semantic.scope === SemanticScope.Entity\n\n/**\n * A type guard to check if a semantic is a PropertySemantic.\n */\nexport const isPropertySemantic = (semantic: DataSemantic): semantic is PropertySemantic =>\n  semantic.scope === SemanticScope.Property\n\n/**\n * A type guard to check if a semantic is a AssociationSemantic.\n */\nexport const isAssociationSemantic = (semantic: DataSemantic): semantic is AssociationSemantic =>\n  semantic.scope === SemanticScope.Association\n\n/**\n * Union type for any kind of data semantic\n */\nexport type DataSemantic = EntitySemantic | PropertySemantic | AssociationSemantic\n\n/**\n * A map to store the definitions of all available data semantics.\n * This acts as a central registry for the application.\n */\nexport const DataSemantics: Record<SemanticType, DataSemantic> = {\n  //\n  // Identity & Authentication\n  //\n\n  [SemanticType.User]: {\n    id: SemanticType.User,\n    displayName: 'User Entity',\n    scope: SemanticScope.Entity,\n    description: 'System users and accounts',\n    category: SemanticCategory.Identity,\n    hasConfig: false,\n    runtime: {\n      timing: SemanticTiming.None,\n      operations: [],\n    },\n  },\n  [SemanticType.Password]: {\n    id: SemanticType.Password,\n    displayName: 'User Password',\n    scope: SemanticScope.Property,\n    description: 'Secure password field',\n    category: SemanticCategory.Identity,\n    applicableDataTypes: ['string'],\n    hasConfig: true,\n    runtime: {\n      timing: SemanticTiming.Before,\n      operations: [SemanticOperation.Create, SemanticOperation.Update],\n      priority: 10, // High priority for security\n      canDisable: false, // Security semantics cannot be disabled\n    },\n  },\n  [SemanticType.UserRole]: {\n    id: SemanticType.UserRole,\n    displayName: 'User Role Field',\n    scope: SemanticScope.Property,\n    description: 'User permissions and access level',\n    category: SemanticCategory.Identity,\n    applicableDataTypes: ['string'],\n    hasConfig: false,\n    runtime: {\n      timing: SemanticTiming.Before,\n      operations: [\n        SemanticOperation.Create,\n        SemanticOperation.Read,\n        SemanticOperation.Update,\n        SemanticOperation.Delete,\n        SemanticOperation.List,\n      ],\n      priority: 20,\n    },\n  },\n  [SemanticType.ResourceOwnerIdentifier]: {\n    id: SemanticType.ResourceOwnerIdentifier,\n    displayName: 'Resource Owner Identifier',\n    scope: SemanticScope.Association,\n    description: 'Links record to owner user',\n    category: SemanticCategory.Identity,\n    hasConfig: false,\n    runtime: {\n      timing: SemanticTiming.Before,\n      operations: [\n        SemanticOperation.Create,\n        SemanticOperation.Read,\n        SemanticOperation.Update,\n        SemanticOperation.Delete,\n        SemanticOperation.List,\n      ],\n      priority: 5, // Very high priority for access control\n      canDisable: false,\n    },\n  },\n\n  //\n  // Timestamps & Versioning\n  //\n\n  [SemanticType.CreatedTimestamp]: {\n    id: SemanticType.CreatedTimestamp,\n    displayName: 'Creation Timestamp',\n    scope: SemanticScope.Property,\n    description: 'When record was created',\n    category: SemanticCategory.Lifecycle,\n    applicableDataTypes: ['datetime'],\n    hasConfig: false,\n    runtime: {\n      timing: SemanticTiming.Before,\n      operations: [SemanticOperation.Create],\n      priority: 90,\n    },\n  },\n  [SemanticType.UpdatedTimestamp]: {\n    id: SemanticType.UpdatedTimestamp,\n    displayName: 'Update Timestamp',\n    scope: SemanticScope.Property,\n    description: 'When record was last modified',\n    category: SemanticCategory.Lifecycle,\n    applicableDataTypes: ['datetime'],\n    hasConfig: false,\n    runtime: {\n      timing: SemanticTiming.Before,\n      operations: [SemanticOperation.Update],\n      priority: 90,\n    },\n  },\n  [SemanticType.DeletedTimestamp]: {\n    id: SemanticType.DeletedTimestamp,\n    displayName: 'Soft Delete Timestamp',\n    scope: SemanticScope.Property,\n    description: 'When record was marked deleted',\n    category: SemanticCategory.Lifecycle,\n    applicableDataTypes: ['datetime'],\n    hasConfig: false,\n    runtime: {\n      timing: SemanticTiming.Before,\n      operations: [SemanticOperation.Delete],\n      priority: 80,\n    },\n  },\n  [SemanticType.DeletedFlag]: {\n    id: SemanticType.DeletedFlag,\n    displayName: 'Soft Delete Flag',\n    scope: SemanticScope.Property,\n    description: 'Mark record as deleted',\n    category: SemanticCategory.Lifecycle,\n    applicableDataTypes: ['boolean'],\n    hasConfig: false,\n    runtime: {\n      timing: SemanticTiming.Before,\n      operations: [SemanticOperation.Delete, SemanticOperation.Read, SemanticOperation.List],\n      priority: 80,\n    },\n  },\n  [SemanticType.Version]: {\n    id: SemanticType.Version,\n    displayName: 'Version Number',\n    scope: SemanticScope.Property,\n    description: 'Auto-incrementing version counter',\n    category: SemanticCategory.Lifecycle,\n    applicableDataTypes: ['number'],\n    hasConfig: false,\n    runtime: {\n      timing: SemanticTiming.Before,\n      operations: [SemanticOperation.Update],\n      priority: 85,\n    },\n  },\n\n  //\n  // Content & Media\n  //\n\n  [SemanticType.Title]: {\n    id: SemanticType.Title,\n    displayName: 'Record Title',\n    scope: SemanticScope.Property,\n    description: 'Main title or heading',\n    category: SemanticCategory.Content,\n    applicableDataTypes: ['string'],\n    hasConfig: false,\n    runtime: {\n      timing: SemanticTiming.None,\n      operations: [],\n    },\n  },\n  [SemanticType.Description]: {\n    id: SemanticType.Description,\n    displayName: 'Description',\n    scope: SemanticScope.Property,\n    description: 'Detailed description text',\n    category: SemanticCategory.Content,\n    applicableDataTypes: ['string'],\n    hasConfig: false,\n    runtime: {\n      timing: SemanticTiming.None,\n      operations: [],\n    },\n  },\n  [SemanticType.Summary]: {\n    id: SemanticType.Summary,\n    displayName: 'Summary',\n    scope: SemanticScope.Property,\n    description: 'Brief summary text',\n    category: SemanticCategory.Content,\n    applicableDataTypes: ['string'],\n    hasConfig: false,\n    runtime: {\n      timing: SemanticTiming.None,\n      operations: [],\n    },\n  },\n  [SemanticType.Markdown]: {\n    id: SemanticType.Markdown,\n    displayName: 'Markdown Content',\n    scope: SemanticScope.Property,\n    description: 'Formatted text content',\n    category: SemanticCategory.Content,\n    applicableDataTypes: ['string'],\n    hasConfig: true,\n    runtime: {\n      timing: SemanticTiming.Before,\n      operations: [SemanticOperation.Create, SemanticOperation.Update],\n      priority: 50, // Process before storage\n    },\n  },\n  [SemanticType.HTML]: {\n    id: SemanticType.HTML,\n    displayName: 'HTML Content',\n    scope: SemanticScope.Property,\n    description: 'Rich HTML content',\n    category: SemanticCategory.Content,\n    applicableDataTypes: ['string'],\n    hasConfig: true,\n    runtime: {\n      timing: SemanticTiming.Before,\n      operations: [SemanticOperation.Create, SemanticOperation.Update],\n      priority: 50, // Process before storage for sanitization\n    },\n  },\n  [SemanticType.ImageURL]: {\n    id: SemanticType.ImageURL,\n    displayName: 'Image URL',\n    scope: SemanticScope.Property,\n    description: 'Link to image file',\n    category: SemanticCategory.Content,\n    applicableDataTypes: ['string'],\n    hasConfig: false,\n    runtime: {\n      timing: SemanticTiming.Before,\n      operations: [SemanticOperation.Create, SemanticOperation.Update],\n      priority: 60, // Validate URLs before storage\n    },\n  },\n  [SemanticType.FileURL]: {\n    id: SemanticType.FileURL,\n    displayName: 'File URL',\n    scope: SemanticScope.Property,\n    description: 'Link to file attachment',\n    category: SemanticCategory.Content,\n    applicableDataTypes: ['string'],\n    hasConfig: false,\n    runtime: {\n      timing: SemanticTiming.Before,\n      operations: [SemanticOperation.Create, SemanticOperation.Update],\n      priority: 60, // Validate URLs before storage\n    },\n  },\n\n  //\n  // Business Data\n  //\n\n  [SemanticType.Status]: {\n    id: SemanticType.Status,\n    displayName: 'Record Status',\n    scope: SemanticScope.Property,\n    description: 'Current state of record',\n    category: SemanticCategory.Business,\n    applicableDataTypes: ['string'],\n    hasConfig: true,\n    runtime: {\n      timing: SemanticTiming.Both,\n      operations: [SemanticOperation.Create, SemanticOperation.Update, SemanticOperation.Read, SemanticOperation.List],\n      priority: 30, // Validate state transitions before, filter by state after\n    },\n  },\n  [SemanticType.Currency]: {\n    id: SemanticType.Currency,\n    displayName: 'Currency',\n    scope: SemanticScope.Property,\n    description: 'Monetary value with currency',\n    category: SemanticCategory.Business,\n    applicableDataTypes: ['number', 'string'],\n    hasConfig: true,\n    runtime: {\n      timing: SemanticTiming.Before,\n      operations: [SemanticOperation.Create, SemanticOperation.Update],\n      priority: 70, // Validate currency format and precision\n    },\n  },\n  [SemanticType.SKU]: {\n    id: SemanticType.SKU,\n    displayName: 'SKU',\n    scope: SemanticScope.Property,\n    description: 'Product identification code',\n    category: SemanticCategory.Business,\n    applicableDataTypes: ['string'],\n    hasConfig: true,\n    runtime: {\n      timing: SemanticTiming.Before,\n      operations: [SemanticOperation.Create, SemanticOperation.Update],\n      priority: 25, // High priority for uniqueness validation\n    },\n  },\n\n  //\n  // Contact Information\n  //\n\n  [SemanticType.Email]: {\n    id: SemanticType.Email,\n    displayName: 'Email',\n    scope: SemanticScope.Property,\n    description: 'Email address',\n    category: SemanticCategory.Contact,\n    applicableDataTypes: ['string'],\n    hasConfig: true,\n    runtime: {\n      timing: SemanticTiming.Before,\n      operations: [SemanticOperation.Create, SemanticOperation.Update],\n      priority: 40, // Validate email format\n    },\n  },\n  [SemanticType.Phone]: {\n    id: SemanticType.Phone,\n    displayName: 'Phone',\n    scope: SemanticScope.Property,\n    description: 'Phone number',\n    category: SemanticCategory.Contact,\n    applicableDataTypes: ['string'],\n    hasConfig: true,\n    runtime: {\n      timing: SemanticTiming.Before,\n      operations: [SemanticOperation.Create, SemanticOperation.Update],\n      priority: 40, // Validate phone format\n    },\n  },\n  [SemanticType.URL]: {\n    id: SemanticType.URL,\n    displayName: 'URL',\n    scope: SemanticScope.Property,\n    description: 'Web address or link',\n    category: SemanticCategory.Contact,\n    applicableDataTypes: ['string'],\n    hasConfig: true,\n    runtime: {\n      timing: SemanticTiming.Before,\n      operations: [SemanticOperation.Create, SemanticOperation.Update],\n      priority: 40, // Validate URL format\n    },\n  },\n\n  //\n  // Classification & Organization\n  //\n\n  [SemanticType.PublicUniqueName]: {\n    id: SemanticType.PublicUniqueName,\n    displayName: 'Public Unique Name (Slug)',\n    scope: SemanticScope.Property,\n    description: 'URL-friendly unique identifier',\n    category: SemanticCategory.Organization,\n    applicableDataTypes: ['string'],\n    hasConfig: true,\n    runtime: {\n      timing: SemanticTiming.Before,\n      operations: [SemanticOperation.Create, SemanticOperation.Update],\n      priority: 30, // Generate slug from title, validate uniqueness\n    },\n  },\n  [SemanticType.Tags]: {\n    id: SemanticType.Tags,\n    displayName: 'Tags',\n    scope: SemanticScope.Association,\n    description: 'Enable tagging functionality',\n    category: SemanticCategory.Organization,\n    hasConfig: true,\n    runtime: {\n      timing: SemanticTiming.After,\n      operations: [SemanticOperation.Create, SemanticOperation.Update, SemanticOperation.Delete],\n      priority: 200, // Process after main operation\n    },\n  },\n  [SemanticType.Categories]: {\n    id: SemanticType.Categories,\n    displayName: 'Categories',\n    scope: SemanticScope.Association,\n    description: 'Enable categorization functionality',\n    category: SemanticCategory.Organization,\n    hasConfig: true,\n    runtime: {\n      timing: SemanticTiming.After,\n      operations: [SemanticOperation.Create, SemanticOperation.Update, SemanticOperation.Delete],\n      priority: 200, // Process after main operation\n    },\n  },\n\n  //\n  // Location & Geography\n  //\n\n  [SemanticType.GeospatialCoordinates]: {\n    id: SemanticType.GeospatialCoordinates,\n    displayName: 'Geospatial Coordinates',\n    scope: SemanticScope.Property,\n    description: 'Location coordinates',\n    category: SemanticCategory.Location,\n    applicableDataTypes: ['string'],\n    hasConfig: true,\n    runtime: {\n      timing: SemanticTiming.Both,\n      operations: [SemanticOperation.Create, SemanticOperation.Update, SemanticOperation.Read, SemanticOperation.List],\n      priority: 60, // Validate coordinates before, enable spatial queries after\n    },\n  },\n\n  //\n  // Computed Values\n  //\n\n  // Calculated field can be added to any data type as we can compute any value.\n  [SemanticType.Calculated]: {\n    id: SemanticType.Calculated,\n    displayName: 'Calculated',\n    scope: SemanticScope.Property,\n    description: 'Auto-calculated field value',\n    category: SemanticCategory.Computed,\n    applicableDataTypes: ['string', 'number', 'boolean', 'date', 'datetime', 'time', 'binary'],\n    hasConfig: true,\n    runtime: {\n      timing: SemanticTiming.Both,\n      operations: [SemanticOperation.Create, SemanticOperation.Update, SemanticOperation.Read],\n      priority: 150, // Calculate after other validations, recalculate on read if needed\n    },\n  },\n  [SemanticType.Derived]: {\n    id: SemanticType.Derived,\n    displayName: 'Derived',\n    scope: SemanticScope.Property,\n    description: 'Value derived from other fields',\n    category: SemanticCategory.Computed,\n    applicableDataTypes: ['string'],\n    hasConfig: true,\n    runtime: {\n      timing: SemanticTiming.After,\n      operations: [SemanticOperation.Create, SemanticOperation.Update],\n      priority: 180, // Derive after all other processing\n    },\n  },\n}\n\n/**\n * Get all semantics that should run for a specific operation and timing\n */\nexport function getSemanticsForOperation(\n  semantics: AppliedDataSemantic[],\n  operation: SemanticOperation,\n  timing: SemanticTiming\n): AppliedDataSemantic[] {\n  return semantics\n    .filter((semantic) => {\n      const definition = DataSemantics[semantic.id]\n      if (!definition?.runtime) {\n        return false\n      }\n\n      const { timing: semanticTiming, operations } = definition.runtime\n\n      // Check if timing matches\n      const timingMatches = semanticTiming === timing || semanticTiming === SemanticTiming.Both\n\n      // Check if operation is included\n      const operationMatches = operations.includes(operation)\n\n      return timingMatches && operationMatches\n    })\n    .sort((a, b) => {\n      // Sort by priority (lower number = higher priority)\n      const priorityA = DataSemantics[a.id]?.runtime?.priority ?? 100\n      const priorityB = DataSemantics[b.id]?.runtime?.priority ?? 100\n      return priorityA - priorityB\n    })\n}\n\n/**\n * Check if a specific semantic can be disabled at runtime\n */\nexport function canSemanticBeDisabled(semanticType: SemanticType): boolean {\n  const definition = DataSemantics[semanticType]\n  return definition?.runtime?.canDisable !== false // Default to true if not specified\n}\n\nexport function getSemanticsByCategory(): Record<SemanticCategory, DataSemantic[]>\nexport function getSemanticsByCategory(scope: SemanticScope.Entity): Record<SemanticCategory, EntitySemantic[]>\nexport function getSemanticsByCategory(scope: SemanticScope.Property): Record<SemanticCategory, PropertySemantic[]>\nexport function getSemanticsByCategory(\n  scope: SemanticScope.Association\n): Record<SemanticCategory, AssociationSemantic[]>\n\n/**\n * Helper function to get all semantics grouped by category.\n * Useful for organizing semantics in UI dropdowns and forms.\n *\n * @param scope Optional scope to filter semantics by (Entity, Property, Association)\n */\nexport function getSemanticsByCategory(scope?: SemanticScope): Record<SemanticCategory, DataSemantic[]> {\n  const result: Record<SemanticCategory, DataSemantic[]> = {\n    [SemanticCategory.Identity]: [],\n    [SemanticCategory.Lifecycle]: [],\n    [SemanticCategory.Content]: [],\n    [SemanticCategory.Business]: [],\n    [SemanticCategory.Contact]: [],\n    [SemanticCategory.Organization]: [],\n    [SemanticCategory.Location]: [],\n    [SemanticCategory.Computed]: [],\n  }\n\n  Object.values(DataSemantics).forEach((semantic) => {\n    // If a scope is provided, filter semantics by that scope\n    if (scope && semantic.scope !== scope) {\n      return\n    }\n    result[semantic.category].push(semantic)\n  })\n\n  return result\n}\n\n/**\n * Helper function to get semantics for a specific category.\n * @param category The category to filter by\n * @returns Array of semantics in the specified category\n */\nexport const getSemanticsByCategoryType = (category: SemanticCategory): DataSemantic[] => {\n  return Object.values(DataSemantics).filter((semantic) => semantic.category === category)\n}\n\n/**\n * Represents the application of a data semantic to a specific\n * entity or property within a user's data model.\n */\nexport interface AppliedDataSemantic {\n  /**\n   * The unique identifier of the semantic being applied.\n   */\n  id: SemanticType\n\n  /**\n   * Optional configuration or values specific to this application.\n   */\n  config?: Record<string, unknown>\n}\n"]}

package/build/src/modeling/definitions/Email.d.ts

@@ -13,10 +13,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).
      */

package/build/src/modeling/definitions/Email.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Email.d.ts","sourceRoot":"","sources":["../../../../src/modeling/definitions/Email.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B;;OAEG;IACH,kBAAkB,CAAC,EAAE,OAAO,GAAG,KAAK,CAAA;IACpC;;OAEG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B;;;;;;;;;;;;OAYG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D,EAAE,EAAE,YAAY,CAAC,KAAK,CAAA;IACtB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,mBAAmB,KAAG,QAAQ,IAAI,oBAE3E,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAQ,WAAgB,KAAG,oBAa9D,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAKlC,CAAA"}
+{"version":3,"file":"Email.d.ts","sourceRoot":"","sources":["../../../../src/modeling/definitions/Email.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B;;OAEG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B;;;;;;;;;;;;OAYG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D,EAAE,EAAE,YAAY,CAAC,KAAK,CAAA;IACtB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,mBAAmB,KAAG,QAAQ,IAAI,oBAE3E,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAQ,WAAgB,KAAG,oBAa9D,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAIlC,CAAA"}

package/build/src/modeling/definitions/Email.js

@@ -25,8 +25,7 @@ export const createEmailSemantic = (config = {}) => {
  * Default configuration for Email semantic.
  */
 export const DEFAULT_EMAIL_CONFIG = {
-    requireVerification: false,
-    verificationMethod: 'email',
+    requireVerification: true,
     allowSubaddressing: true,
     allowInternational: true,
 };