npm - @api-client/core - Versions diffs - 0.17.4 → 0.17.6 - Mend

@api-client/core 0.17.4 → 0.17.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (64) hide show

package/build/src/modeling/Semantics.d.ts CHANGED Viewed

@@ -38,11 +38,12 @@ export declare enum SemanticType {
      */
     DeletedFlag = "Semantic#DeletedFlag",
     /**
-     * Designates a Data Property as a unique public identifier for a resource (the slug).
+     * Designates a Data Property as a public identifier for a resource (the slug).
      * This is often used in URLs to provide a user-friendly way to access the resource.
      * For example, a blog post might have a public unique name like "my-first-post".
-     * A URL-friendly text field. The runtime automatically generates a unique, URL-safe string from another field (like a title or name). The user needs to specify which field is used to generate
-     * the slug.
+     * The runtime automatically generates a URL-safe string from another field (like a title).
+     * By default, slugs are generated to be unique, but the configuration allows for duplicates
+     * in scenarios where uniqueness is handled by a combination of fields (e.g., year and slug).
      */
     PublicUniqueName = "Semantic#PublicUniqueName",
     /**
@@ -130,9 +131,12 @@ export declare enum SemanticType {
     /**
      * Annotates a field as a monetary value with currency support and precision control.
      * Can store simple decimal amounts or complex objects with amount and currency.
-     * Enforces proper decimal handling to avoid floating-point errors.
+     *
+     * As a semantic, it provides flexibility by annotating a base `number` or `string` type,
+     * allowing for different storage strategies (e.g., decimal, integer cents, or a JSON object)
+     * while maintaining a consistent API for currency operations.
      */
-    Price = "Semantic#Price",
+    Currency = "Semantic#Currency",
     /**
      * Annotates a field as a URL with validation and allowed protocols.
      */

package/build/src/modeling/Semantics.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"Semantics.d.ts","sourceRoot":"","sources":["../../../src/modeling/Semantics.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAEzD;;;GAGG;AACH,oBAAY,YAAY;IAKtB;;OAEG;IACH,IAAI,kBAAkB;IAMtB;;;;OAIG;IACH,QAAQ,sBAAsB;IAC9B;;;OAGG;IACH,gBAAgB,8BAA8B;IAC9C;;;OAGG;IACH,gBAAgB,8BAA8B;IAC9C;;;;;OAKG;IACH,gBAAgB,8BAA8B;IAC9C;;;;OAIG;IACH,WAAW,yBAAyB;IACpC~~;;;;;;OAMG~~;IACH,gBAAgB,8BAA8B;IAC9C;;;;OAIG;IACH,KAAK,mBAAmB;IACxB;;;;;;OAMG;IACH,QAAQ,sBAAsB;IAC9B;;;;;;;;;OASG;IACH,MAAM,oBAAoB;IAE1B;;;;OAIG;IACH,OAAO,qBAAqB;IAE5B;;;OAGG;IACH,QAAQ,sBAAsB;IAE9B;;;OAGG;IACH,OAAO,qBAAqB;IAE5B;;;;;;OAMG;IACH,QAAQ,sBAAsB;IAE9B;;;;;;OAMG;IACH,IAAI,kBAAkB;IAEtB;;;;;;;;;;;;;;;OAeG;IACH,qBAAqB,mCAAmC;IAExD;;OAEG;IACH,KAAK,mBAAmB;IACxB;;OAEG;IACH,KAAK,mBAAmB;IACxB~~;;;;OAIG~~;IACH,~~KAAK~~,~~mBAAmB~~;~~IACxB~~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"}
1	+ {"version":3,"file":"Semantics.d.ts","sourceRoot":"","sources":["../../../src/modeling/Semantics.ts"],"names":[],"mappings":"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"}

package/build/src/modeling/Semantics.js CHANGED Viewed

@@ -44,11 +44,12 @@ export var SemanticType;
      */
     SemanticType["DeletedFlag"] = "Semantic#DeletedFlag";
     /**
-     * Designates a Data Property as a unique public identifier for a resource (the slug).
+     * Designates a Data Property as a public identifier for a resource (the slug).
      * This is often used in URLs to provide a user-friendly way to access the resource.
      * For example, a blog post might have a public unique name like "my-first-post".
-     * A URL-friendly text field. The runtime automatically generates a unique, URL-safe string from another field (like a title or name). The user needs to specify which field is used to generate
-     * the slug.
+     * The runtime automatically generates a URL-safe string from another field (like a title).
+     * By default, slugs are generated to be unique, but the configuration allows for duplicates
+     * in scenarios where uniqueness is handled by a combination of fields (e.g., year and slug).
      */
     SemanticType["PublicUniqueName"] = "Semantic#PublicUniqueName";
     /**
@@ -136,9 +137,12 @@ export var SemanticType;
     /**
      * Annotates a field as a monetary value with currency support and precision control.
      * Can store simple decimal amounts or complex objects with amount and currency.
-     * Enforces proper decimal handling to avoid floating-point errors.
+     *
+     * As a semantic, it provides flexibility by annotating a base `number` or `string` type,
+     * allowing for different storage strategies (e.g., decimal, integer cents, or a JSON object)
+     * while maintaining a consistent API for currency operations.
      */
-    SemanticType["Price"] = "Semantic#Price";
+    SemanticType["Currency"] = "Semantic#Currency";
     /**
      * Annotates a field as a URL with validation and allowed protocols.
      */
@@ -371,7 +375,7 @@ export const DataSemantics = {
         description: 'Detailed description text',
         category: SemanticCategory.Content,
         applicableDataTypes: ['string'],
-        hasConfig: true,
+        hasConfig: false,
     },
     [SemanticType.Summary]: {
         id: SemanticType.Summary,
@@ -380,7 +384,7 @@ export const DataSemantics = {
         description: 'Brief summary text',
         category: SemanticCategory.Content,
         applicableDataTypes: ['string'],
-        hasConfig: true,
+        hasConfig: false,
     },
     [SemanticType.Markdown]: {
         id: SemanticType.Markdown,
@@ -430,9 +434,9 @@ export const DataSemantics = {
         applicableDataTypes: ['string'],
         hasConfig: true,
     },
-    [SemanticType.Price]: {
-        id: SemanticType.Price,
-        displayName: 'Price',
+    [SemanticType.Currency]: {
+        id: SemanticType.Currency,
+        displayName: 'Currency',
         scope: SemanticScope.Property,
         description: 'Monetary value with currency',
         category: SemanticCategory.Business,

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

	@@ -1 +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 unique 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 * A URL-friendly text field. The runtime automatically generates a unique, URL-safe string from another field (like a title or name). The user needs to specify which field is used to generate\n * the 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 * Enforces proper decimal handling to avoid floating-point errors.\n /\n Price = 'Semantic#Price',\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: true,\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: true,\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.Price]: {\n id: SemanticType.Price,\n displayName: 'Price',\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 [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'],\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"]}
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 [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'],\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"]}

package/build/src/modeling/definitions/{Price.d.ts → Currency.d.ts} RENAMED Viewed

@@ -3,12 +3,12 @@ import { SemanticType } from '../Semantics.js';
 /**
  * Supported storage formats for monetary values.
  */
-export type PriceStorageFormat = 'decimal' | 'integer_cents' | 'complex_object';
+export type CurrencyStorageFormat = 'decimal' | 'integer_cents' | 'complex_object';
 /**
- * Configuration options for the Price semantic.
+ * Configuration options for the Currency semantic.
  * Controls monetary value storage, validation, currency handling, and precision.
  */
-export interface PriceConfig {
+export interface CurrencyConfig {
     /**
      * How the monetary value is stored in the database.
      *
@@ -16,7 +16,7 @@ export interface PriceConfig {
      * - 'integer_cents': Store as INTEGER in smallest currency unit (e.g., 1999 for $19.99)
      * - 'complex_object': Store as JSON/JSONB with amount and currency (e.g., {"amount": 1999, "currency": "USD"})
      */
-    storageFormat?: PriceStorageFormat;
+    storageFormat?: CurrencyStorageFormat;
     /**
      * Default currency code (ISO 4217) when not specified.
      * Required when using 'decimal' or 'integer_cents' format.
@@ -42,7 +42,7 @@ export interface PriceConfig {
      */
     validateCurrencyCode?: boolean;
     /**
-     * Custom metadata for the price field.
+     * Custom metadata for the currency field.
      */
     metadata?: Record<string, unknown>;
     /**
@@ -51,52 +51,52 @@ export interface PriceConfig {
     [key: string]: unknown;
 }
 /**
- * Type-safe configuration for Price semantic.
+ * Type-safe configuration for Currency semantic.
  */
-export interface AppliedPriceSemantic extends AppliedDataSemantic {
-    id: SemanticType.Price;
-    config?: PriceConfig;
+export interface AppliedCurrencySemantic extends AppliedDataSemantic {
+    id: SemanticType.Currency;
+    config?: CurrencyConfig;
 }
 /**
- * Type guard to check if a semantic is a Price semantic.
+ * Type guard to check if a semantic is a Currency semantic.
  */
-export declare const isPriceSemantic: (semantic: AppliedDataSemantic) => semantic is AppliedPriceSemantic;
+export declare const isCurrencySemantic: (semantic: AppliedDataSemantic) => semantic is AppliedCurrencySemantic;
 /**
- * Helper function to create a Price semantic with configuration.
+ * Helper function to create a Currency semantic with configuration.
  */
-export declare const createPriceSemantic: (config?: PriceConfig) => AppliedPriceSemantic;
+export declare const createCurrencySemantic: (config?: CurrencyConfig) => AppliedCurrencySemantic;
 /**
- * Default configuration for Price semantic.
+ * Default configuration for Currency semantic.
  * Optimized for common e-commerce use cases with USD currency.
  */
-export declare const DEFAULT_PRICE_CONFIG: PriceConfig;
+export declare const DEFAULT_CURRENCY_CONFIG: CurrencyConfig;
 /**
  * Predefined configurations for common use cases.
  */
-export declare const PRICE_PRESETS: {
+export declare const CURRENCY_PRESETS: {
     /**
      * Simple USD decimal storage - good for most e-commerce sites.
      */
-    readonly USD_DECIMAL: AppliedPriceSemantic;
+    readonly USD_DECIMAL: AppliedCurrencySemantic;
     /**
      * Integer cents storage - avoids floating point issues, good for financial calculations.
      */
-    readonly USD_CENTS: AppliedPriceSemantic;
+    readonly USD_CENTS: AppliedCurrencySemantic;
     /**
      * Multi-currency support with complex object storage.
      */
-    readonly MULTI_CURRENCY: AppliedPriceSemantic;
+    readonly MULTI_CURRENCY: AppliedCurrencySemantic;
     /**
      * Configuration that allows negative values for refunds, discounts, etc.
      */
-    readonly WITH_NEGATIVES: AppliedPriceSemantic;
+    readonly WITH_NEGATIVES: AppliedCurrencySemantic;
     /**
      * High-precision configuration for cryptocurrency or precious metals.
      */
-    readonly HIGH_PRECISION: AppliedPriceSemantic;
+    readonly HIGH_PRECISION: AppliedCurrencySemantic;
 };
 /**
- * Helper function to validate a price configuration.
+ * Helper function to validate a currency configuration.
  */
-export declare const validatePriceConfig: (config: PriceConfig) => string[];
-//# sourceMappingURL=Price.d.ts.map
+export declare const validateCurrencyConfig: (config: CurrencyConfig) => string[];
+//# sourceMappingURL=Currency.d.ts.map

package/build/src/modeling/definitions/Currency.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"Currency.d.ts","sourceRoot":"","sources":["../../../../src/modeling/definitions/Currency.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,eAAe,GAAG,gBAAgB,CAAA;AAElF;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,qBAAqB,CAAA;IAErC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IAExB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAE5B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IAEvB;;OAEG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAE9B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAElC;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,mBAAmB;IAClE,EAAE,EAAE,YAAY,CAAC,QAAQ,CAAA;IACzB,MAAM,CAAC,EAAE,cAAc,CAAA;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,UAAU,mBAAmB,KAAG,QAAQ,IAAI,uBAE9E,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAQ,cAAmB,KAAG,uBAepE,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,cAMrC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;OAEG;;IAQH;;OAEG;;IAQH;;OAEG;;IAQH;;OAEG;;IAQH;;OAEG;;CAOK,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,sBAAsB,GAAI,QAAQ,cAAc,KAAG,MAAM,EAYrE,CAAA"}

package/build/src/modeling/definitions/{Price.js → Currency.js} RENAMED Viewed

@@ -1,16 +1,16 @@
 import { SemanticType } from '../Semantics.js';
 /**
- * Type guard to check if a semantic is a Price semantic.
+ * Type guard to check if a semantic is a Currency semantic.
  */
-export const isPriceSemantic = (semantic) => {
-    return semantic.id === SemanticType.Price;
+export const isCurrencySemantic = (semantic) => {
+    return semantic.id === SemanticType.Currency;
 };
 /**
- * Helper function to create a Price semantic with configuration.
+ * Helper function to create a Currency semantic with configuration.
  */
-export const createPriceSemantic = (config = {}) => {
+export const createCurrencySemantic = (config = {}) => {
     const mergedConfig = {
-        ...DEFAULT_PRICE_CONFIG,
+        ...DEFAULT_CURRENCY_CONFIG,
         ...config,
     };
     // Merge metadata separately
@@ -18,15 +18,15 @@ export const createPriceSemantic = (config = {}) => {
         mergedConfig.metadata = { ...config.metadata };
     }
     return {
-        id: SemanticType.Price,
+        id: SemanticType.Currency,
         config: mergedConfig,
     };
 };
 /**
- * Default configuration for Price semantic.
+ * Default configuration for Currency semantic.
  * Optimized for common e-commerce use cases with USD currency.
  */
-export const DEFAULT_PRICE_CONFIG = {
+export const DEFAULT_CURRENCY_CONFIG = {
     storageFormat: 'decimal',
     defaultCurrency: 'USD',
     decimalPlaces: 2,
@@ -36,11 +36,11 @@ export const DEFAULT_PRICE_CONFIG = {
 /**
  * Predefined configurations for common use cases.
  */
-export const PRICE_PRESETS = {
+export const CURRENCY_PRESETS = {
     /**
      * Simple USD decimal storage - good for most e-commerce sites.
      */
-    USD_DECIMAL: createPriceSemantic({
+    USD_DECIMAL: createCurrencySemantic({
         storageFormat: 'decimal',
         defaultCurrency: 'USD',
         decimalPlaces: 2,
@@ -49,7 +49,7 @@ export const PRICE_PRESETS = {
     /**
      * Integer cents storage - avoids floating point issues, good for financial calculations.
      */
-    USD_CENTS: createPriceSemantic({
+    USD_CENTS: createCurrencySemantic({
         storageFormat: 'integer_cents',
         defaultCurrency: 'USD',
         decimalPlaces: 2,
@@ -58,7 +58,7 @@ export const PRICE_PRESETS = {
     /**
      * Multi-currency support with complex object storage.
      */
-    MULTI_CURRENCY: createPriceSemantic({
+    MULTI_CURRENCY: createCurrencySemantic({
         storageFormat: 'complex_object',
         allowedCurrencies: ['USD', 'EUR', 'GBP', 'JPY', 'CAD'],
         decimalPlaces: 2,
@@ -67,7 +67,7 @@ export const PRICE_PRESETS = {
     /**
      * Configuration that allows negative values for refunds, discounts, etc.
      */
-    WITH_NEGATIVES: createPriceSemantic({
+    WITH_NEGATIVES: createCurrencySemantic({
         storageFormat: 'decimal',
         defaultCurrency: 'USD',
         decimalPlaces: 2,
@@ -76,7 +76,7 @@ export const PRICE_PRESETS = {
     /**
      * High-precision configuration for cryptocurrency or precious metals.
      */
-    HIGH_PRECISION: createPriceSemantic({
+    HIGH_PRECISION: createCurrencySemantic({
         storageFormat: 'decimal',
         defaultCurrency: 'BTC',
         decimalPlaces: 8,
@@ -84,9 +84,9 @@ export const PRICE_PRESETS = {
     }),
 };
 /**
- * Helper function to validate a price configuration.
+ * Helper function to validate a currency configuration.
  */
-export const validatePriceConfig = (config) => {
+export const validateCurrencyConfig = (config) => {
     const errors = [];
     if (config.storageFormat !== 'complex_object' && !config.defaultCurrency) {
         errors.push('defaultCurrency is required when storageFormat is not complex_object');
@@ -96,4 +96,4 @@ export const validatePriceConfig = (config) => {
     }
     return errors;
 };
-//# sourceMappingURL=Price.js.map
+//# sourceMappingURL=Currency.js.map

package/build/src/modeling/definitions/Currency.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"Currency.js","sourceRoot":"","sources":["../../../../src/modeling/definitions/Currency.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAqE9C;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,QAA6B,EAAuC,EAAE;IACvG,OAAO,QAAQ,CAAC,EAAE,KAAK,YAAY,CAAC,QAAQ,CAAA;AAC9C,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,SAAyB,EAAE,EAA2B,EAAE;IAC7F,MAAM,YAAY,GAAG;QACnB,GAAG,uBAAuB;QAC1B,GAAG,MAAM;KACV,CAAA;IAED,4BAA4B;IAC5B,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,YAAY,CAAC,QAAQ,GAAG,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;IAChD,CAAC;IAED,OAAO;QACL,EAAE,EAAE,YAAY,CAAC,QAAQ;QACzB,MAAM,EAAE,YAAY;KACrB,CAAA;AACH,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAmB;IACrD,aAAa,EAAE,SAAS;IACxB,eAAe,EAAE,KAAK;IACtB,aAAa,EAAE,CAAC;IAChB,aAAa,EAAE,KAAK;IACpB,oBAAoB,EAAE,IAAI;CAC3B,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B;;OAEG;IACH,WAAW,EAAE,sBAAsB,CAAC;QAClC,aAAa,EAAE,SAAS;QACxB,eAAe,EAAE,KAAK;QACtB,aAAa,EAAE,CAAC;QAChB,aAAa,EAAE,KAAK;KACrB,CAAC;IAEF;;OAEG;IACH,SAAS,EAAE,sBAAsB,CAAC;QAChC,aAAa,EAAE,eAAe;QAC9B,eAAe,EAAE,KAAK;QACtB,aAAa,EAAE,CAAC;QAChB,aAAa,EAAE,KAAK;KACrB,CAAC;IAEF;;OAEG;IACH,cAAc,EAAE,sBAAsB,CAAC;QACrC,aAAa,EAAE,gBAAgB;QAC/B,iBAAiB,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;QACtD,aAAa,EAAE,CAAC;QAChB,aAAa,EAAE,KAAK;KACrB,CAAC;IAEF;;OAEG;IACH,cAAc,EAAE,sBAAsB,CAAC;QACrC,aAAa,EAAE,SAAS;QACxB,eAAe,EAAE,KAAK;QACtB,aAAa,EAAE,CAAC;QAChB,aAAa,EAAE,IAAI;KACpB,CAAC;IAEF;;OAEG;IACH,cAAc,EAAE,sBAAsB,CAAC;QACrC,aAAa,EAAE,SAAS;QACxB,eAAe,EAAE,KAAK;QACtB,aAAa,EAAE,CAAC;QAChB,aAAa,EAAE,KAAK;KACrB,CAAC;CACM,CAAA;AAEV;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,MAAsB,EAAY,EAAE;IACzE,MAAM,MAAM,GAAa,EAAE,CAAA;IAE3B,IAAI,MAAM,CAAC,aAAa,KAAK,gBAAgB,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;QACzE,MAAM,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAA;IACrF,CAAC;IAED,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS,IAAI,MAAM,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;QACnE,MAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAA;IACnD,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA","sourcesContent":["import type { AppliedDataSemantic } from '../Semantics.js'\nimport { SemanticType } from '../Semantics.js'\n\n/**\n * Supported storage formats for monetary values.\n */\nexport type CurrencyStorageFormat = 'decimal' | 'integer_cents' | 'complex_object'\n\n/**\n * Configuration options for the Currency semantic.\n * Controls monetary value storage, validation, currency handling, and precision.\n */\nexport interface CurrencyConfig {\n /**\n * How the monetary value is stored in the database.\n *\n * - 'decimal': Store as DECIMAL/NUMERIC type (e.g., 19.99)\n * - 'integer_cents': Store as INTEGER in smallest currency unit (e.g., 1999 for $19.99)\n * - 'complex_object': Store as JSON/JSONB with amount and currency (e.g., {\"amount\": 1999, \"currency\": \"USD\"})\n */\n storageFormat?: CurrencyStorageFormat\n\n /**\n * Default currency code (ISO 4217) when not specified.\n * Required when using 'decimal' or 'integer_cents' format.\n */\n defaultCurrency?: string\n\n /**\n * List of allowed currency codes (ISO 4217).\n * If not specified, all valid ISO 4217 currencies are allowed.\n */\n allowedCurrencies?: string[]\n\n /**\n * Number of decimal places for precision.\n * Default: 2 (for most currencies like USD, EUR)\n * Some currencies may need 0 (JPY, KRW) or 3 (BHD, KWD)\n */\n decimalPlaces?: number\n\n /**\n * Whether negative values are allowed (for refunds, discounts, etc.).\n */\n allowNegative?: boolean\n\n /**\n * Whether to automatically validate currency codes against ISO 4217.\n */\n validateCurrencyCode?: boolean\n\n /**\n * Custom metadata for the currency field.\n */\n metadata?: Record<string, unknown>\n\n /**\n * Index signature to allow additional properties.\n */\n [key: string]: unknown\n}\n\n/**\n * Type-safe configuration for Currency semantic.\n */\nexport interface AppliedCurrencySemantic extends AppliedDataSemantic {\n id: SemanticType.Currency\n config?: CurrencyConfig\n}\n\n/**\n * Type guard to check if a semantic is a Currency semantic.\n */\nexport const isCurrencySemantic = (semantic: AppliedDataSemantic): semantic is AppliedCurrencySemantic => {\n return semantic.id === SemanticType.Currency\n}\n\n/**\n * Helper function to create a Currency semantic with configuration.\n */\nexport const createCurrencySemantic = (config: CurrencyConfig = {}): AppliedCurrencySemantic => {\n const mergedConfig = {\n ...DEFAULT_CURRENCY_CONFIG,\n ...config,\n }\n\n // Merge metadata separately\n if (config.metadata) {\n mergedConfig.metadata = { ...config.metadata }\n }\n\n return {\n id: SemanticType.Currency,\n config: mergedConfig,\n }\n}\n\n/**\n * Default configuration for Currency semantic.\n * Optimized for common e-commerce use cases with USD currency.\n */\nexport const DEFAULT_CURRENCY_CONFIG: CurrencyConfig = {\n storageFormat: 'decimal',\n defaultCurrency: 'USD',\n decimalPlaces: 2,\n allowNegative: false,\n validateCurrencyCode: true,\n}\n\n/**\n * Predefined configurations for common use cases.\n */\nexport const CURRENCY_PRESETS = {\n /**\n * Simple USD decimal storage - good for most e-commerce sites.\n */\n USD_DECIMAL: createCurrencySemantic({\n storageFormat: 'decimal',\n defaultCurrency: 'USD',\n decimalPlaces: 2,\n allowNegative: false,\n }),\n\n /**\n * Integer cents storage - avoids floating point issues, good for financial calculations.\n */\n USD_CENTS: createCurrencySemantic({\n storageFormat: 'integer_cents',\n defaultCurrency: 'USD',\n decimalPlaces: 2,\n allowNegative: false,\n }),\n\n /**\n * Multi-currency support with complex object storage.\n */\n MULTI_CURRENCY: createCurrencySemantic({\n storageFormat: 'complex_object',\n allowedCurrencies: ['USD', 'EUR', 'GBP', 'JPY', 'CAD'],\n decimalPlaces: 2,\n allowNegative: false,\n }),\n\n /**\n * Configuration that allows negative values for refunds, discounts, etc.\n */\n WITH_NEGATIVES: createCurrencySemantic({\n storageFormat: 'decimal',\n defaultCurrency: 'USD',\n decimalPlaces: 2,\n allowNegative: true,\n }),\n\n /**\n * High-precision configuration for cryptocurrency or precious metals.\n */\n HIGH_PRECISION: createCurrencySemantic({\n storageFormat: 'decimal',\n defaultCurrency: 'BTC',\n decimalPlaces: 8,\n allowNegative: false,\n }),\n} as const\n\n/**\n * Helper function to validate a currency configuration.\n */\nexport const validateCurrencyConfig = (config: CurrencyConfig): string[] => {\n const errors: string[] = []\n\n if (config.storageFormat !== 'complex_object' && !config.defaultCurrency) {\n errors.push('defaultCurrency is required when storageFormat is not complex_object')\n }\n\n if (config.decimalPlaces !== undefined && config.decimalPlaces < 0) {\n errors.push('decimalPlaces must be non-negative')\n }\n\n return errors\n}\n"]}

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

@@ -14,9 +14,9 @@ export interface EmailConfig {
      */
     requireVerification?: boolean;
     /**
-     * Method to use for verification: 'email', 'sms', or 'none'.
+     * Method to use for verification: 'email' or 'sms'.
      */
-    verificationMethod?: 'email' | 'sms' | 'none';
+    verificationMethod?: 'email' | 'sms';
     /**
      * Whether to allow subaddressing (user+tag@domain.com).
      */

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

	@@ -1 +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,~~GAAG,MAAM,~~CAAA;~~IAC7C~~;;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"}
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"}

package/build/src/modeling/definitions/Email.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"Email.js","sourceRoot":"","sources":["../../../../src/modeling/definitions/Email.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAuD9C;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAA6B,EAAoC,EAAE;IACjG,OAAO,QAAQ,CAAC,EAAE,KAAK,YAAY,CAAC,KAAK,CAAA;AAC3C,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,SAAsB,EAAE,EAAwB,EAAE;IACpF,MAAM,YAAY,GAAG;QACnB,GAAG,oBAAoB;QACvB,GAAG,MAAM;KACV,CAAA;IACD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,YAAY,CAAC,QAAQ,GAAG,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;IAChD,CAAC;IAED,OAAO;QACL,EAAE,EAAE,YAAY,CAAC,KAAK;QACtB,MAAM,EAAE,YAAY;KACrB,CAAA;AACH,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,mBAAmB,EAAE,KAAK;IAC1B,kBAAkB,EAAE,OAAO;IAC3B,kBAAkB,EAAE,IAAI;IACxB,kBAAkB,EAAE,IAAI;CACzB,CAAA","sourcesContent":["import type { AppliedDataSemantic } from '../Semantics.js'\nimport { SemanticType } from '../Semantics.js'\n\n/*\n Configuration options for the Email semantic.\n * Controls validation, allowed domains, and verification.\n /\nexport interface EmailConfig {\n /\n List of allowed email domains (e.g., ['example.com']).\n /\n allowedDomains?: string[]\n /\n Whether email verification is required.\n /\n requireVerification?: boolean\n /\n Method to use for verification: 'email', ~~'sms',~~ or '~~none~~'.\n /\n verificationMethod?: 'email' \| 'sms' ~~\| 'none'~~\n /\n Whether to allow subaddressing (user+tag@domain.com).\n /\n allowSubaddressing?: boolean\n /\n Whether to allow internationalized email addresses.\n \n - When true (default): Allows email addresses with non-ASCII characters in the domain part,\n * like user@münchen.de or user@café.com\n * - When false: Only allows ASCII characters in the domain part, like user@example.com\n \n Why it exists:\n * - Internationalization: Many countries have domain names with native characters (like German umlauts,\n * French accents, etc.)\n * - RFC 6531: The standard for internationalized email addresses\n * - Validation flexibility: Some systems may need to restrict to ASCII-only domains for compatibility reasons\n /\n allowInternational?: boolean\n /\n Custom metadata for the email field.\n /\n metadata?: Record<string, unknown>\n /\n Index signature to allow additional properties.\n /\n [key: string]: unknown\n}\n\n/\n Type-safe configuration for Email semantic.\n /\nexport interface AppliedEmailSemantic extends AppliedDataSemantic {\n id: SemanticType.Email\n config?: EmailConfig\n}\n\n/\n Type guard to check if a semantic is an Email semantic.\n /\nexport const isEmailSemantic = (semantic: AppliedDataSemantic): semantic is AppliedEmailSemantic => {\n return semantic.id === SemanticType.Email\n}\n\n/\n Helper function to create an Email semantic with configuration.\n /\nexport const createEmailSemantic = (config: EmailConfig = {}): AppliedEmailSemantic => {\n const mergedConfig = {\n ...DEFAULT_EMAIL_CONFIG,\n ...config,\n }\n if (config.metadata) {\n mergedConfig.metadata = { ...config.metadata }\n }\n\n return {\n id: SemanticType.Email,\n config: mergedConfig,\n }\n}\n\n/\n Default configuration for Email semantic.\n */\nexport const DEFAULT_EMAIL_CONFIG: EmailConfig = {\n requireVerification: false,\n verificationMethod: 'email',\n allowSubaddressing: true,\n allowInternational: true,\n}\n"]}
1	+ {"version":3,"file":"Email.js","sourceRoot":"","sources":["../../../../src/modeling/definitions/Email.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAuD9C;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAA6B,EAAoC,EAAE;IACjG,OAAO,QAAQ,CAAC,EAAE,KAAK,YAAY,CAAC,KAAK,CAAA;AAC3C,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,SAAsB,EAAE,EAAwB,EAAE;IACpF,MAAM,YAAY,GAAG;QACnB,GAAG,oBAAoB;QACvB,GAAG,MAAM;KACV,CAAA;IACD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,YAAY,CAAC,QAAQ,GAAG,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;IAChD,CAAC;IAED,OAAO;QACL,EAAE,EAAE,YAAY,CAAC,KAAK;QACtB,MAAM,EAAE,YAAY;KACrB,CAAA;AACH,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,mBAAmB,EAAE,KAAK;IAC1B,kBAAkB,EAAE,OAAO;IAC3B,kBAAkB,EAAE,IAAI;IACxB,kBAAkB,EAAE,IAAI;CACzB,CAAA","sourcesContent":["import type { AppliedDataSemantic } from '../Semantics.js'\nimport { SemanticType } from '../Semantics.js'\n\n/*\n Configuration options for the Email semantic.\n * Controls validation, allowed domains, and verification.\n /\nexport interface EmailConfig {\n /\n List of allowed email domains (e.g., ['example.com']).\n /\n allowedDomains?: string[]\n /\n Whether email verification is required.\n /\n requireVerification?: boolean\n /\n Method to use for verification: 'email' or 'sms'.\n /\n verificationMethod?: 'email' \| 'sms'\n /\n Whether to allow subaddressing (user+tag@domain.com).\n /\n allowSubaddressing?: boolean\n /\n Whether to allow internationalized email addresses.\n \n - When true (default): Allows email addresses with non-ASCII characters in the domain part,\n * like user@münchen.de or user@café.com\n * - When false: Only allows ASCII characters in the domain part, like user@example.com\n \n Why it exists:\n * - Internationalization: Many countries have domain names with native characters (like German umlauts,\n * French accents, etc.)\n * - RFC 6531: The standard for internationalized email addresses\n * - Validation flexibility: Some systems may need to restrict to ASCII-only domains for compatibility reasons\n /\n allowInternational?: boolean\n /\n Custom metadata for the email field.\n /\n metadata?: Record<string, unknown>\n /\n Index signature to allow additional properties.\n /\n [key: string]: unknown\n}\n\n/\n Type-safe configuration for Email semantic.\n /\nexport interface AppliedEmailSemantic extends AppliedDataSemantic {\n id: SemanticType.Email\n config?: EmailConfig\n}\n\n/\n Type guard to check if a semantic is an Email semantic.\n /\nexport const isEmailSemantic = (semantic: AppliedDataSemantic): semantic is AppliedEmailSemantic => {\n return semantic.id === SemanticType.Email\n}\n\n/\n Helper function to create an Email semantic with configuration.\n /\nexport const createEmailSemantic = (config: EmailConfig = {}): AppliedEmailSemantic => {\n const mergedConfig = {\n ...DEFAULT_EMAIL_CONFIG,\n ...config,\n }\n if (config.metadata) {\n mergedConfig.metadata = { ...config.metadata }\n }\n\n return {\n id: SemanticType.Email,\n config: mergedConfig,\n }\n}\n\n/\n Default configuration for Email semantic.\n */\nexport const DEFAULT_EMAIL_CONFIG: EmailConfig = {\n requireVerification: false,\n verificationMethod: 'email',\n allowSubaddressing: true,\n allowInternational: true,\n}\n"]}