@api-client/core 0.18.20 → 0.18.21

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

@@ -42074,10 +42074,10 @@
 "@id": "#200"
 },
 {
-"@id": "#206"
+"@id": "#203"
 },
 {
-"@id": "#203"
+"@id": "#206"
 },
 {
 "@id": "#209"
@@ -43520,7 +43520,7 @@
 "doc:ExternalDomainElement",
 "doc:DomainElement"
 ],
-"doc:raw": "code: '7487'\ndescription: 'Financial and insurance activities'\ntype: \"PRIMARY\"\nclassificationCode: 'BE_NACEBEL2008'\nactivityGroupCode: 'ABCDE'\n",
+"doc:raw": "code: 'J'\ndescription: 'Information and communication'\n",
 "core:mediaType": "application/yaml",
 "sourcemaps:sources": [
 {
@@ -43541,7 +43541,7 @@
 "doc:ExternalDomainElement",
 "doc:DomainElement"
 ],
-"doc:raw": "code: 'J'\ndescription: 'Information and communication'\n",
+"doc:raw": "code: '7487'\ndescription: 'Financial and insurance activities'\ntype: \"PRIMARY\"\nclassificationCode: 'BE_NACEBEL2008'\nactivityGroupCode: 'ABCDE'\n",
 "core:mediaType": "application/yaml",
 "sourcemaps:sources": [
 {
@@ -44776,12 +44776,12 @@
 {
 "@id": "#205/source-map/lexical/element_0",
 "sourcemaps:element": "amf://id#205",
-"sourcemaps:value": "[(1,0)-(6,0)]"
+"sourcemaps:value": "[(1,0)-(3,0)]"
 },
 {
 "@id": "#208/source-map/lexical/element_0",
 "sourcemaps:element": "amf://id#208",
-"sourcemaps:value": "[(1,0)-(3,0)]"
+"sourcemaps:value": "[(1,0)-(6,0)]"
 },
 {
 "@id": "#223/source-map/lexical/element_0",

package/package.json

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

package/src/modeling/templates/meta/blog-publishing-platform.json

@@ -0,0 +1 @@
+{"id":"blog-publishing-platform","name":"Blog Publishing Platform","description":"A comprehensive content management and publishing platform for blogs, magazines, and digital publications. Includes content management, user roles, publishing workflow, and social features.","createdAt":"2025-07-27T21:14:57.328Z","updatedAt":"2025-07-27T21:14:57.328Z","version":"1.0.0","author":"API Now! Core Team","tags":["blog","cms","publishing","content","media","editorial"],"structure":{"domain":{"name":"Blog Publishing Platform","description":"A comprehensive content management and publishing platform for blogs, magazines, and digital publications","totalEntities":8,"totalProperties":68,"totalAssociations":14},"namespaces":[{"name":"ContentManagement","displayName":"Content Management","description":"Core content creation, editing, and organization features","modelCount":2,"entityCount":4,"models":[{"name":"Publications","displayName":"Publications Management","description":"Individual blogs, magazines, or publications within the platform","entityCount":1,"entities":[{"name":"publication","displayName":"Publication","description":"Individual blog or publication site","propertyCount":8,"associationCount":0,"properties":[{"name":"id","displayName":"Publication ID","description":"Unique identifier for the publication","type":"string","primary":true,"readOnly":true,"semantics":[]},{"name":"name","displayName":"Publication Name","description":"Display name of the publication","type":"string","semantics":["Semantic#Title"]},{"name":"slug","displayName":"URL Slug","description":"URL-friendly identifier for the publication","type":"string","required":true,"unique":true,"semantics":["Semantic#PublicUniqueName"]},{"name":"description","displayName":"Description","description":"Publication description and tagline","type":"string","semantics":["Semantic#Description"]},{"name":"domain","displayName":"Custom Domain","description":"Custom domain name for the publication","type":"string","semantics":[]},{"name":"logo_url","displayName":"Logo URL","description":"URL to publication logo image","type":"string","semantics":["Semantic#ImageURL"]},{"name":"status","displayName":"Publication Status","description":"Current status of the publication","type":"string","required":true,"semantics":["Semantic#Status"],"enumValues":["active","suspended","archived"],"defaultValue":"active"},{"name":"created_at","displayName":"Created At","description":"When the publication was created","type":"datetime","readOnly":true,"semantics":["Semantic#CreatedTimestamp"]}],"associations":[],"semantics":[]}]},{"name":"Content","displayName":"Content Management","description":"Posts, pages, and other content types","entityCount":3,"entities":[{"name":"category","displayName":"Content Category","description":"Content categorization for organization and navigation","propertyCount":5,"associationCount":2,"properties":[{"name":"id","displayName":"Category ID","description":"Unique identifier for the category","type":"string","primary":true,"readOnly":true,"semantics":[]},{"name":"name","displayName":"Category Name","description":"Display name of the category","type":"string","semantics":["Semantic#Title"]},{"name":"slug","displayName":"URL Slug","description":"URL-friendly identifier for the category","type":"string","required":true,"unique":true,"semantics":["Semantic#PublicUniqueName"]},{"name":"description","displayName":"Description","description":"Category description","type":"string","semantics":["Semantic#Description"]},{"name":"color","displayName":"Color","description":"Theme color for the category","type":"string","semantics":[]}],"associations":[{"name":"publication","displayName":"Publication","description":"Publication this category belongs to","required":true,"multiple":false,"targetEntities":["publication"],"semantics":[],"cardinality":"One-to-One"},{"name":"parentCategory","displayName":"Parent Category","description":"Parent category for hierarchical organization","required":false,"multiple":false,"targetEntities":["category"],"semantics":[],"cardinality":"One-to-One"}],"semantics":[]},{"name":"Tag","displayName":"Content Tag","description":"Tags for flexible content labeling and discovery","propertyCount":3,"associationCount":1,"properties":[{"name":"id","displayName":"Tag ID","description":"Unique identifier for the tag","type":"string","primary":true,"readOnly":true,"semantics":[]},{"name":"name","displayName":"Tag Name","description":"Display name of the tag","type":"string","semantics":["Semantic#Title"]},{"name":"slug","displayName":"URL Slug","description":"URL-friendly identifier for the tag","type":"string","required":true,"unique":true,"semantics":["Semantic#PublicUniqueName"]}],"associations":[{"name":"publication","displayName":"Publication","description":"Publication this tag belongs to","required":true,"multiple":false,"targetEntities":["publication"],"semantics":[],"cardinality":"One-to-One"}],"semantics":[]},{"name":"Post","displayName":"Blog Post","description":"Individual blog posts and articles","propertyCount":16,"associationCount":4,"properties":[{"name":"id","displayName":"Post ID","description":"Unique identifier for the post","type":"string","primary":true,"readOnly":true,"semantics":[]},{"name":"title","displayName":"Post Title","description":"Title of the blog post","type":"string","required":true,"semantics":["Semantic#Title"]},{"name":"slug","displayName":"URL Slug","description":"URL-friendly identifier for the post","type":"string","required":true,"unique":true,"semantics":["Semantic#PublicUniqueName"]},{"name":"excerpt","displayName":"Excerpt","description":"Brief summary or excerpt of the post","type":"string","semantics":["Semantic#Summary"]},{"name":"content","displayName":"Content","description":"Full content of the post in HTML or Markdown","type":"string","required":true,"semantics":["Semantic#HTML"]},{"name":"content_format","displayName":"Content Format","description":"Format of the content (HTML, Markdown, etc.)","type":"string","required":true,"semantics":[],"enumValues":["html","markdown","richtext"],"defaultValue":"markdown"},{"name":"featured_image_url","displayName":"Featured Image URL","description":"URL to featured image","type":"string","semantics":["Semantic#ImageURL"]},{"name":"status","displayName":"Post Status","description":"Current publishing status of the post","type":"string","required":true,"semantics":["Semantic#Status"],"enumValues":["draft","pending_review","scheduled","published","archived"],"defaultValue":"draft"},{"name":"published_at","displayName":"Published At","description":"When the post was published","type":"datetime","readOnly":true,"semantics":["Semantic#CreatedTimestamp"]},{"name":"scheduled_at","displayName":"Scheduled At","description":"When the post is scheduled to be published","type":"datetime","semantics":[]},{"name":"view_count","displayName":"View Count","description":"Number of times the post has been viewed","type":"number","required":true,"semantics":[]},{"name":"reading_time","displayName":"Reading Time","description":"Estimated reading time in minutes","type":"number","readOnly":true,"semantics":["Semantic#Calculated"]},{"name":"word_count","displayName":"Word Count","description":"Number of words in the post content","type":"number","readOnly":true,"semantics":["Semantic#Calculated"]},{"name":"meta_title","displayName":"Meta Title","description":"SEO meta title","type":"string","semantics":[]},{"name":"meta_description","displayName":"Meta Description","description":"SEO meta description","type":"string","semantics":[]},{"name":"updated_at","displayName":"Updated At","description":"When the post was last updated","type":"datetime","readOnly":true,"semantics":["Semantic#UpdatedTimestamp"]}],"associations":[{"name":"publication","displayName":"Publication","description":"Publication this post belongs to","required":true,"multiple":false,"targetEntities":["publication"],"semantics":[],"cardinality":"One-to-One"},{"name":"categories","displayName":"Post Categories","description":"Categories this post belongs to","required":false,"multiple":true,"targetEntities":["category"],"semantics":["Semantic#Categories"],"cardinality":"One-to-Many"},{"name":"tags","displayName":"Post Tags","description":"Tags associated with this post","required":false,"multiple":true,"targetEntities":["Tag"],"semantics":["Semantic#Tags"],"cardinality":"One-to-Many"},{"name":"author","displayName":"Post Author","description":"Author who wrote this post","required":true,"multiple":false,"targetEntities":["user"],"semantics":["Semantic#ResourceOwnerIdentifier"],"cardinality":"One-to-One"}],"semantics":[]}]}]},{"name":"UserManagement","displayName":"User Management","description":"Authors, editors, subscribers, and user roles management","modelCount":1,"entityCount":1,"models":[{"name":"Users","displayName":"User Management","description":"User accounts and authentication","entityCount":1,"entities":[{"name":"user","displayName":"User Account","description":"User account for authors, editors, and subscribers","propertyCount":13,"associationCount":0,"properties":[{"name":"id","displayName":"User ID","description":"Unique identifier for the user","type":"string","primary":true,"readOnly":true,"semantics":[]},{"name":"email","displayName":"Email Address","description":"User email address for login and communication","type":"string","required":true,"semantics":["Semantic#Email"]},{"name":"password","displayName":"Password","description":"Encrypted password for authentication","type":"string","required":true,"semantics":["Semantic#Password"]},{"name":"username","displayName":"Username","description":"Unique username for the user","type":"string","required":true,"unique":true,"semantics":["Semantic#PublicUniqueName"]},{"name":"display_name","displayName":"Display Name","description":"Public display name for the user","type":"string","required":true,"semantics":[]},{"name":"first_name","displayName":"First Name","description":"User first name","type":"string","semantics":[]},{"name":"last_name","displayName":"Last Name","description":"User last name","type":"string","semantics":[]},{"name":"bio","displayName":"Biography","description":"User biography and description","type":"string","semantics":["Semantic#Description"]},{"name":"avatar_url","displayName":"Avatar URL","description":"URL to user profile picture","type":"string","semantics":["Semantic#ImageURL"]},{"name":"website","displayName":"Website","description":"User personal website URL","type":"string","semantics":["Semantic#URL"]},{"name":"role","displayName":"User Role","description":"User role for permission management","type":"string","required":true,"semantics":["Semantic#Status"],"enumValues":["subscriber","author","editor","admin","super_admin"],"defaultValue":"subscriber"},{"name":"emailVerified","displayName":"Email Verified","description":"Whether the user has verified their email","type":"boolean","required":true,"semantics":[],"defaultValue":"false"},{"name":"created_at","displayName":"Created At","description":"When the user account was created","type":"datetime","readOnly":true,"semantics":["Semantic#CreatedTimestamp"]}],"associations":[],"semantics":["Semantic#User"]}]}]},{"name":"SocialFeatures","displayName":"Social Features","description":"Comments, likes, shares, and social interactions","modelCount":1,"entityCount":1,"models":[{"name":"Comments","displayName":"Comment System","description":"Post comments and replies","entityCount":1,"entities":[{"name":"comment","displayName":"Comment","description":"User comments on posts","propertyCount":7,"associationCount":3,"properties":[{"name":"id","displayName":"Comment ID","description":"Unique identifier for the comment","type":"string","primary":true,"readOnly":true,"semantics":[]},{"name":"content","displayName":"Comment Content","description":"Content of the comment","type":"string","required":true,"semantics":[]},{"name":"author_name","displayName":"Author Name","description":"Name of the comment author (for guest comments)","type":"string","semantics":[]},{"name":"author_email","displayName":"Author Email","description":"Email of the comment author (for guest comments)","type":"string","required":true,"semantics":["Semantic#Email"]},{"name":"status","displayName":"Comment Status","description":"Moderation status of the comment","type":"string","required":true,"semantics":["Semantic#Status"],"enumValues":["pending","approved","rejected","spam"],"defaultValue":"pending"},{"name":"user_agent","displayName":"User Agent","description":"Browser user agent string","type":"string","semantics":[]},{"name":"created_at","displayName":"Created At","description":"When the comment was created","type":"datetime","readOnly":true,"semantics":["Semantic#CreatedTimestamp"]}],"associations":[{"name":"post","displayName":"Post","description":"Post this comment belongs to","required":true,"multiple":false,"targetEntities":["Post"],"semantics":[],"cardinality":"One-to-One"},{"name":"author","displayName":"Comment Author","description":"Registered user who wrote this comment","required":false,"multiple":false,"targetEntities":["user"],"semantics":["Semantic#ResourceOwnerIdentifier"],"cardinality":"One-to-One"},{"name":"parent_comment","displayName":"Parent Comment","description":"Parent comment for replies","required":false,"multiple":false,"targetEntities":["comment"],"semantics":[],"cardinality":"One-to-One"}],"semantics":[]}]}]},{"name":"Analytics","displayName":"Analytics & Tracking","description":"Analytics, metrics, and performance tracking","modelCount":1,"entityCount":1,"models":[{"name":"Analytics","displayName":"Content Analytics","description":"Content performance and user engagement metrics","entityCount":1,"entities":[{"name":"page_view","displayName":"Page View","description":"Individual page view tracking record","propertyCount":6,"associationCount":2,"properties":[{"name":"id","displayName":"Page View ID","description":"Unique identifier for the page view","type":"string","primary":true,"readOnly":true,"semantics":[]},{"name":"path","displayName":"Page Path","description":"URL path of the viewed page","type":"string","required":true,"semantics":[]},{"name":"referrer","displayName":"Referrer","description":"Referring URL","type":"string","semantics":["Semantic#URL"]},{"name":"user_agent","displayName":"User Agent","description":"Browser user agent string","type":"string","semantics":[]},{"name":"session_id","displayName":"Session ID","description":"Visitor session identifier","type":"string","semantics":[]},{"name":"viewed_at","displayName":"Viewed At","description":"When the page was viewed","type":"datetime","readOnly":true,"semantics":["Semantic#CreatedTimestamp"]}],"associations":[{"name":"post","displayName":"Viewed Post","description":"Post that was viewed (if applicable)","required":false,"multiple":false,"targetEntities":["Post"],"semantics":[],"cardinality":"One-to-One"},{"name":"publication","displayName":"Publication","description":"Publication this page view belongs to","required":true,"multiple":false,"targetEntities":["publication"],"semantics":[],"cardinality":"One-to-One"}],"semantics":[]}]}]},{"name":"MediaManagement","displayName":"Media Management","description":"Image, video, and file upload management","modelCount":1,"entityCount":1,"models":[{"name":"Media","displayName":"Media Library","description":"Uploaded files, images, and media assets","entityCount":1,"entities":[{"name":"media_file","displayName":"Media File","description":"Uploaded media files (images, videos, documents)","propertyCount":10,"associationCount":2,"properties":[{"name":"id","displayName":"Media File ID","description":"Unique identifier for the media file","type":"string","primary":true,"readOnly":true,"semantics":[]},{"name":"filename","displayName":"File Name","description":"Original filename of the uploaded file","type":"string","required":true,"semantics":[]},{"name":"storage_key","displayName":"Storage Key","description":"Unique storage key for the file","type":"string","required":true,"unique":true,"semantics":[]},{"name":"url","displayName":"File URL","description":"Public URL to access the file","type":"string","required":true,"semantics":["Semantic#URL"]},{"name":"mime_type","displayName":"MIME Type","description":"MIME type of the file","type":"string","required":true,"semantics":[]},{"name":"file_size","displayName":"File Size","description":"File size in bytes","type":"number","required":true,"semantics":[]},{"name":"width","displayName":"Image Width","description":"Width in pixels (for images)","type":"number","required":true,"semantics":[]},{"name":"height","displayName":"Image Height","description":"Height in pixels (for images)","type":"number","required":true,"semantics":[]},{"name":"alt_text","displayName":"Alt Text","description":"Alternative text for accessibility","type":"string","semantics":[]},{"name":"uploaded_at","displayName":"Uploaded At","description":"When the file was uploaded","type":"datetime","readOnly":true,"semantics":["Semantic#CreatedTimestamp"]}],"associations":[{"name":"uploader","displayName":"File Uploader","description":"User who uploaded this file","required":true,"multiple":false,"targetEntities":["user"],"semantics":["Semantic#ResourceOwnerIdentifier"],"cardinality":"One-to-One"},{"name":"publication","displayName":"Publication","description":"Publication this media file belongs to","required":true,"multiple":false,"targetEntities":["publication"],"semantics":[],"cardinality":"One-to-One"}],"semantics":[]}]}]}]}}

package/src/modeling/templates/meta/ecommerce-platform.json

@@ -0,0 +1 @@
+{"id":"ecommerce-platform","name":"E-Commerce Platform","description":"A comprehensive e-commerce platform with user management, product catalog, inventory, and order processing capabilities. Perfect for online stores, marketplaces, and retail businesses.","createdAt":"2025-07-27T21:14:57.328Z","updatedAt":"2025-07-27T21:14:57.328Z","version":"1.0.0","author":"API Now! Core Team","tags":["e-commerce","retail","shopping","business","inventory","orders"],"structure":{"domain":{"name":"E-Commerce Platform","description":"A comprehensive e-commerce platform with user management, product catalog, and order processing capabilities","totalEntities":11,"totalProperties":73,"totalAssociations":14},"namespaces":[{"name":"UserManagement","displayName":"User Management","description":"Handles user authentication, authorization, and profile management","modelCount":2,"entityCount":3,"models":[{"name":"Authentication","displayName":"User Authentication","description":"User accounts and authentication data","entityCount":1,"entities":[{"name":"User","displayName":"User Account","description":"Represents a user account in the system","propertyCount":9,"associationCount":2,"properties":[{"name":"id","displayName":"User ID","description":"Unique identifier for the user","type":"string","primary":true,"readOnly":true,"semantics":[]},{"name":"email","displayName":"Email Address","description":"User email address for login and communication","type":"string","required":true,"semantics":["Semantic#Email"]},{"name":"password","displayName":"Password","description":"User password for authentication","type":"string","required":true,"semantics":["Semantic#Password"]},{"name":"first_name","displayName":"First Name","description":"User first name","type":"string","required":true,"semantics":[]},{"name":"last_name","displayName":"Last Name","description":"User last name","type":"string","required":true,"semantics":[]},{"name":"role","displayName":"User Role","description":"User role for permission management","type":"string","required":true,"semantics":["Semantic#UserRole"],"enumValues":["customer","admin","moderator"],"defaultValue":"customer"},{"name":"email_verified","displayName":"Email Verified","description":"Whether the user has verified their email address","type":"boolean","required":true,"semantics":[],"defaultValue":"false"},{"name":"created_at","displayName":"Created At","description":"When the user account was created","type":"datetime","readOnly":true,"semantics":["Semantic#CreatedTimestamp"]},{"name":"updated_at","displayName":"Updated At","description":"When the user account was last updated","type":"datetime","readOnly":true,"semantics":["Semantic#UpdatedTimestamp"]}],"associations":[{"name":"profile","displayName":"User Profile","description":"Link to extended profile information","required":false,"multiple":false,"targetEntities":["user_profile"],"semantics":[],"cardinality":"One-to-One"},{"name":"addresses","displayName":"User Addresses","description":"User shipping and billing addresses","required":false,"multiple":true,"targetEntities":["address"],"semantics":[],"cardinality":"One-to-Many"}],"semantics":["Semantic#User"]}]},{"name":"UserProfile","displayName":"User Profile","description":"Extended user profile information","entityCount":2,"entities":[{"name":"user_profile","displayName":"User Profile","description":"Extended profile information for users","propertyCount":4,"associationCount":0,"properties":[{"name":"id","displayName":"Profile ID","description":"Unique identifier for the profile","type":"string","primary":true,"readOnly":true,"semantics":[]},{"name":"birthdate","displayName":"Date of Birth","description":"User date of birth","type":"date","semantics":[]},{"name":"phone","displayName":"Phone Number","description":"User phone number","type":"string","semantics":["Semantic#Phone"]},{"name":"avatar_url","displayName":"Avatar URL","description":"URL to user profile picture","type":"string","semantics":["Semantic#ImageURL"]}],"associations":[],"semantics":[]},{"name":"address","displayName":"Address","description":"Physical address information","propertyCount":9,"associationCount":0,"properties":[{"name":"id","displayName":"Address ID","description":"Unique identifier for the address","type":"string","primary":true,"readOnly":true,"semantics":[]},{"name":"type","displayName":"Address Type","description":"Type of address (shipping, billing, etc.)","type":"string","required":true,"semantics":[],"enumValues":["shipping","billing","both"]},{"name":"line1","displayName":"Address Line 1","description":"Primary street address, including house number and street name","type":"string","required":true,"semantics":[]},{"name":"line2","displayName":"Address Line 2","description":"Optional field for additional street-level information like apartment numbers or building names.","type":"string","required":false,"semantics":[]},{"name":"line3","displayName":"Address Line 3","description":"Optional field for additional street-level information like apartment numbers or building names.","type":"string","required":false,"semantics":[]},{"name":"city","displayName":"City","description":"City name","type":"string","required":true,"semantics":[]},{"name":"state","displayName":"State/Province","description":"State or province","type":"string","required":true,"semantics":[]},{"name":"postal_code","displayName":"ZIP/Postal Code","description":"ZIP or postal code","type":"string","required":true,"semantics":[]},{"name":"country","displayName":"Country","description":"Country name","type":"string","required":true,"semantics":[]}],"associations":[],"semantics":[]}]}]},{"name":"ProductCatalog","displayName":"Product Catalog","description":"Product information, categories, and inventory management","modelCount":2,"entityCount":3,"models":[{"name":"Products","displayName":"Product Management","description":"Core product entities and relationships","entityCount":2,"entities":[{"name":"category","displayName":"Product Category","description":"Product categorization for organization and navigation","propertyCount":4,"associationCount":1,"properties":[{"name":"id","displayName":"Category ID","description":"Unique identifier for the category","type":"string","primary":true,"readOnly":true,"semantics":[]},{"name":"name","displayName":"Category Name","description":"Display name of the category","type":"string","semantics":["Semantic#Title"]},{"name":"slug","displayName":"URL Slug","description":"URL-friendly identifier for the category","type":"string","required":true,"unique":true,"semantics":["Semantic#PublicUniqueName"]},{"name":"description","displayName":"Description","description":"Category description","type":"string","semantics":["Semantic#Description"]}],"associations":[{"name":"parent_category","displayName":"Parent Category","description":"Parent category for hierarchical organization","required":false,"multiple":false,"targetEntities":["category"],"semantics":[],"cardinality":"One-to-One"}],"semantics":[]},{"name":"product","displayName":"Product","description":"Core product information and specifications","propertyCount":13,"associationCount":2,"properties":[{"name":"id","displayName":"Product ID","description":"Unique identifier for the product","type":"string","primary":true,"readOnly":true,"semantics":[]},{"name":"name","displayName":"Product Name","description":"Display name of the product","type":"string","semantics":["Semantic#Title"]},{"name":"slug","displayName":"URL Slug","description":"URL-friendly identifier for the product","type":"string","required":true,"unique":true,"semantics":["Semantic#PublicUniqueName"]},{"name":"description","displayName":"Description","description":"Detailed product description","type":"string","semantics":["Semantic#Description"]},{"name":"short_description","displayName":"Short Description","description":"Brief product summary","type":"string","semantics":["Semantic#Summary"]},{"name":"sku","displayName":"SKU","description":"Stock Keeping Unit - unique product identifier","type":"string","required":true,"unique":true,"semantics":["Semantic#SKU"]},{"name":"price","displayName":"Price","description":"Product price in cents (USD)","type":"number","required":true,"semantics":["Semantic#Currency"]},{"name":"compare_at_price","displayName":"Compare at Price","description":"Original price for discount display","type":"number","semantics":["Semantic#Currency"]},{"name":"status","displayName":"Status","description":"Current status of the product","type":"string","required":true,"semantics":["Semantic#Status"],"enumValues":["inactive","active","pending","archived"],"defaultValue":"inactive"},{"name":"weight","displayName":"Weight","description":"Product weight in grams","type":"number","semantics":[]},{"name":"images","displayName":"Images","description":"Array of product image URLs","type":"string","multiple":true,"semantics":["Semantic#ImageURL"]},{"name":"created_at","displayName":"Created At","description":"When the product was created","type":"datetime","readOnly":true,"semantics":["Semantic#CreatedTimestamp"]},{"name":"updated_at","displayName":"Updated At","description":"When the product was last updated","type":"datetime","readOnly":true,"semantics":["Semantic#UpdatedTimestamp"]}],"associations":[{"name":"categories","displayName":"Product Categories","description":"Categories this product belongs to","required":true,"multiple":true,"targetEntities":["category"],"semantics":["Semantic#Categories"],"cardinality":"One-to-Many"},{"name":"inventory","displayName":"Product Inventory","description":"Inventory information for this product","required":true,"multiple":false,"targetEntities":["inventory"],"semantics":[],"cardinality":"One-to-One"}],"semantics":[]}]},{"name":"Inventory","displayName":"Inventory Management","description":"Stock levels and inventory tracking","entityCount":1,"entities":[{"name":"inventory","displayName":"Inventory","description":"Stock levels and inventory information for products","propertyCount":4,"associationCount":0,"properties":[{"name":"id","displayName":"Inventory ID","description":"Unique identifier for the inventory record","type":"string","primary":true,"readOnly":true,"semantics":[]},{"name":"quantity","displayName":"Stock Quantity","description":"Available stock quantity","type":"number","required":true,"semantics":[],"defaultValue":"0"},{"name":"trackQuantity","displayName":"Track Quantity","description":"Whether to track inventory for this product","type":"boolean","required":true,"semantics":[],"defaultValue":"true"},{"name":"allowBackorder","displayName":"Allow Backorder","description":"Whether to allow ordering when out of stock","type":"boolean","required":true,"semantics":[],"defaultValue":"false"}],"associations":[],"semantics":[]}]}]},{"name":"OrderManagement","displayName":"Order Management","description":"Shopping cart, orders, and payment processing","modelCount":3,"entityCount":5,"models":[{"name":"ShoppingCart","displayName":"Shopping Cart","description":"Shopping cart and cart items","entityCount":2,"entities":[{"name":"cart","displayName":"Shopping Cart","description":"User shopping cart","propertyCount":5,"associationCount":2,"properties":[{"name":"id","displayName":"Cart ID","description":"Unique identifier for the cart","type":"string","primary":true,"readOnly":true,"semantics":[]},{"name":"sessionId","displayName":"Session ID","description":"Session identifier for guest carts","type":"string","semantics":[]},{"name":"expiresAt","displayName":"Expires At","description":"When the cart expires for cleanup","type":"datetime","semantics":[]},{"name":"created_at","displayName":"Created At","description":"When the cart was created","type":"datetime","readOnly":true,"semantics":["Semantic#CreatedTimestamp"]},{"name":"updated_at","displayName":"Updated At","description":"When the cart was last updated","type":"datetime","readOnly":true,"semantics":["Semantic#UpdatedTimestamp"]}],"associations":[{"name":"user","displayName":"Cart Owner","description":"User who owns this cart","required":false,"multiple":false,"targetEntities":["User"],"semantics":["Semantic#ResourceOwnerIdentifier"],"cardinality":"One-to-One"},{"name":"items","displayName":"Cart Items","description":"Items in this cart","required":false,"multiple":true,"targetEntities":["cart_item"],"semantics":[],"cardinality":"One-to-Many"}],"semantics":[]},{"name":"cart_item","displayName":"Cart Item","description":"Individual items in a shopping cart","propertyCount":4,"associationCount":1,"properties":[{"name":"id","displayName":"Cart Item ID","description":"Unique identifier for the cart item","type":"string","primary":true,"readOnly":true,"semantics":[]},{"name":"quantity","displayName":"Quantity","description":"Number of items","type":"number","required":true,"semantics":[]},{"name":"unitPrice","displayName":"Unit Price","description":"Price per unit at time of adding to cart","type":"number","required":true,"semantics":["Semantic#Currency"]},{"name":"total_price","displayName":"Total Price","description":"Total price for this line item","type":"number","required":true,"readOnly":true,"semantics":["Semantic#Currency","Semantic#Calculated"]}],"associations":[{"name":"product","displayName":"Product","description":"Product for this cart item","required":true,"multiple":false,"targetEntities":["product"],"semantics":[],"cardinality":"One-to-One"}],"semantics":[]}]},{"name":"Orders","displayName":"Order Processing","description":"Orders and order fulfillment","entityCount":2,"entities":[{"name":"order","displayName":"Order","description":"Customer order","propertyCount":10,"associationCount":5,"properties":[{"name":"id","displayName":"Order ID","description":"Unique identifier for the order","type":"string","primary":true,"readOnly":true,"semantics":[]},{"name":"order_number","displayName":"Order Number","description":"Human-readable order number","type":"string","required":true,"unique":true,"semantics":[]},{"name":"status","displayName":"Order Status","description":"Current status of the order","type":"string","required":true,"semantics":["Semantic#Status"],"enumValues":["pending","confirmed","processing","shipped","delivered","cancelled","refunded"],"defaultValue":"pending"},{"name":"subtotal","displayName":"Subtotal","description":"Order subtotal before taxes and shipping","type":"number","required":true,"semantics":["Semantic#Currency"]},{"name":"taxAmount","displayName":"Tax Amount","description":"Total tax amount","type":"number","required":true,"semantics":["Semantic#Currency"]},{"name":"shippingAmount","displayName":"Shipping Amount","description":"Shipping cost","type":"number","required":true,"semantics":["Semantic#Currency"]},{"name":"total_amount","displayName":"Total Amount","description":"Final order total","type":"number","required":true,"semantics":["Semantic#Currency","Semantic#Calculated"]},{"name":"notes","displayName":"Order Notes","description":"Customer notes or special instructions","type":"string","semantics":[]},{"name":"created_at","displayName":"Created At","description":"When the order was created","type":"datetime","readOnly":true,"semantics":["Semantic#CreatedTimestamp"]},{"name":"updated_at","displayName":"Updated At","description":"When the order was last updated","type":"datetime","readOnly":true,"semantics":["Semantic#UpdatedTimestamp"]}],"associations":[{"name":"customer","displayName":"Customer","description":"Customer who placed this order","required":true,"multiple":false,"targetEntities":["User"],"semantics":["Semantic#ResourceOwnerIdentifier"],"cardinality":"One-to-One"},{"name":"shipping_address","displayName":"Shipping Address","description":"Address for order delivery","required":true,"multiple":false,"targetEntities":["address"],"semantics":[],"cardinality":"One-to-One"},{"name":"billing_address","displayName":"Billing Address","description":"Address for billing purposes","required":true,"multiple":false,"targetEntities":["address"],"semantics":[],"cardinality":"One-to-One"},{"name":"items","displayName":"Order Items","description":"Items in this order","required":true,"multiple":true,"targetEntities":["order_item"],"semantics":[],"cardinality":"One-to-Many"},{"name":"payments","displayName":"Order Payments","description":"Payment transactions for this order","required":false,"multiple":true,"targetEntities":["payment"],"semantics":[],"cardinality":"One-to-Many"}],"semantics":[]},{"name":"order_item","displayName":"Order Line Item","description":"Individual line items in an order","propertyCount":4,"associationCount":1,"properties":[{"name":"id","displayName":"Order Item ID","description":"Unique identifier for the order item","type":"string","primary":true,"readOnly":true,"semantics":[]},{"name":"quantity","displayName":"Quantity","description":"Number of items ordered","type":"number","required":true,"semantics":[]},{"name":"unitPrice","displayName":"Unit Price","description":"Price per unit at time of order","type":"number","required":true,"semantics":["Semantic#Currency"]},{"name":"total_price","displayName":"Total Price","description":"Total price for this line item","type":"number","required":true,"readOnly":true,"semantics":["Semantic#Currency","Semantic#Calculated"]}],"associations":[{"name":"product","displayName":"Product","description":"Product for this order item","required":true,"multiple":false,"targetEntities":["product"],"semantics":[],"cardinality":"One-to-One"}],"semantics":[]}]},{"name":"Payments","displayName":"Payment Processing","description":"Payment methods and transactions","entityCount":1,"entities":[{"name":"payment","displayName":"Payment","description":"Payment transaction record","propertyCount":7,"associationCount":0,"properties":[{"name":"id","displayName":"Payment ID","description":"Unique identifier for the payment","type":"string","primary":true,"readOnly":true,"semantics":[]},{"name":"method","displayName":"Payment Method","description":"Method used for payment","type":"string","required":true,"semantics":[],"enumValues":["credit_card","debit_card","paypal","bank_transfer","apple_pay","google_pay"]},{"name":"status","displayName":"Payment Status","description":"Current status of the payment","type":"string","required":true,"semantics":["Semantic#Status"],"enumValues":["pending","authorized","captured","failed","cancelled","refunded"],"defaultValue":"pending"},{"name":"amount","displayName":"Payment Amount","description":"Amount charged","type":"number","required":true,"semantics":["Semantic#Currency"]},{"name":"currency","displayName":"Currency","description":"Currency code for the payment","type":"string","required":true,"semantics":[],"defaultValue":"USD"},{"name":"transaction_id","displayName":"Transaction ID","description":"External payment processor transaction ID","type":"string","semantics":[]},{"name":"created_at","displayName":"Created At","description":"When the payment was created","type":"datetime","readOnly":true,"semantics":["Semantic#CreatedTimestamp"]}],"associations":[],"semantics":[]}]}]}]}}

package/src/modeling/templates/readme.md

@@ -0,0 +1,246 @@
+# Domain Templates
+
+The domain templates allow creating or updating existing data domains from a template. Templates follow the Domain-Driven Design (DDD) principles and provide pre-built business domain structures that users can instantiate or extend.
+
+## Template Structure
+
+Each template is a TypeScript file that exports a default function conforming to the template signature. Templates create comprehensive data domains with proper namespace organization, entity relationships, and semantic annotations.
+
+### Required Function Signature
+
+```typescript
+import type { CreateTemplateOptions } from './types.js'
+import { DataDomain } from '../DataDomain.js'
+
+export default function createMyDomain(options: CreateTemplateOptions = {}): DataDomain {
+  // Template implementation
+}
+```
+
+### Template Implementation Pattern
+
+```typescript
+/**
+ * Template Documentation Header
+ * 
+ * Provide comprehensive documentation explaining:
+ * - What business domain this template models
+ * - Key entities and relationships included
+ * - Semantic annotations and business rules applied
+ * - Example usage scenarios
+ */
+
+import { DataDomain } from '../DataDomain.js'
+import { SemanticType } from '../Semantics.js'
+import {
+  addIdField,
+  addNameField,
+  addEmailField,
+  // Import other helper functions as needed
+} from '../helpers/Intelisense.js'
+import type { CreateTemplateOptions } from './types.js'
+
+function createDomain(): DataDomain {
+  return new DataDomain({
+    info: {
+      name: 'My Business Domain',
+      displayName: 'My Business Domain',
+      description: 'Clear description of what this domain models',
+    },
+  })
+}
+
+export default function createMyDomain(options: CreateTemplateOptions = {}): DataDomain {
+  // Use existing domain if provided, otherwise create new one
+  const domain = options.domain ?? createDomain()
+  
+  // Create namespaces following business capabilities
+  const coreNamespace = domain.addNamespace({ 
+    info: { name: 'CoreManagement' } 
+  })
+  
+  // Add models to organize related entities
+  const entityModel = coreNamespace.addModel({ 
+    info: { name: 'CoreEntities' } 
+  })
+  
+  // Create entities with proper semantic annotations
+  const mainEntity = entityModel.addEntity({ 
+    info: { name: 'MainEntity' },
+    semantics: [{ type: SemanticType.User }] // If applicable
+  })
+  
+  // Add properties using helper functions for consistency
+  addIdField(mainEntity)
+  addNameField(mainEntity)
+  addEmailField(mainEntity)
+  
+  // Add custom properties with proper semantics
+  mainEntity.addProperty({
+    info: { name: 'customField' },
+    type: 'string',
+    required: false,
+    semantics: [/* appropriate semantics */]
+  })
+  
+  // Create associations between entities
+  // (Add more entities and relationships as needed)
+  
+  return domain
+}
+```
+
+## Adding a Template
+
+### 1. Create the Template File
+
+Create a new file `[domain-name]-domain.ts` in `src/modeling/templates/` following the naming convention:
+
+- Use kebab-case for file names
+- End with `-domain.ts`
+- Examples: `healthcare-domain.ts`, `financial-services-domain.ts`
+
+### 2. Follow Modeling Guidelines
+
+Templates must adhere to the modeling instructions in `.github/instructions/modeling.instructions.md`:
+
+- **Business-First Approach**: Model business concepts, not technical concerns
+- **Proper Hierarchy**: DataDomain → DomainNamespace → DomainModel → DomainEntity → DomainProperty
+- **Semantic Annotations**: Use `SemanticType` for passwords, emails, timestamps, etc.
+- **Security**: Mark sensitive properties as `writeOnly`, validate all inputs
+- **Database Compliance**: Follow PostgreSQL naming conventions (snake_case conversion)
+
+### 3. Required Imports
+
+Include these essential imports:
+
+```typescript
+import { DataDomain } from '../DataDomain.js'
+import { SemanticType } from '../Semantics.js'
+import type { CreateTemplateOptions } from './types.js'
+
+// Import semantic definition helpers as needed
+import { createCalculatedSemantic } from '../definitions/Calculated.js'
+import { createCurrencySemantic } from '../definitions/Currency.js'
+
+// Import property helper functions for consistency
+import {
+  addIdField,
+  addNameField,
+  addEmailField,
+  addPasswordField,
+  addCreatedAtField,
+  addUpdatedAtField,
+  // ... other helpers as needed
+} from '../helpers/Intelisense.js'
+```
+
+### 4. Handle Template Options
+
+Always support the `CreateTemplateOptions` interface:
+
+```typescript
+export default function createMyDomain(options: CreateTemplateOptions = {}): DataDomain {
+  // Use provided domain or create new one
+  const domain = options.domain ?? createDomain()
+  
+  // If domain is provided, you're extending an existing domain
+  // If not provided, you're creating a new domain
+  
+  return domain
+}
+```
+
+## Registering Templates
+
+### 1. Add to Generation Script
+
+Edit `scripts/generate-template-metadata.js` and add your template to the registry:
+
+```javascript
+// Import your template function
+import createMyDomain from '../build/src/modeling/templates/my-domain.js'
+
+// Add to templates array
+const TEMPLATE_CONFIGS = [
+  {
+    id: 'my-business-domain',
+    name: 'My Business Domain',
+    description: 'Brief description for UI display',
+    version: '1.0.0',
+    author: 'API Now! Core Team',
+    tags: ['business', 'industry-specific'], // For categorization
+    createdAt: '2025-01-01T00:00:00.000Z',
+    updatedAt: '2025-01-01T00:00:00.000Z',
+    createDomainFn: createMyDomain,
+  },
+  // ... other templates
+]
+```
+
+### 2. Template Metadata
+
+The generation script will create metadata including:
+
+- Template structure analysis (namespaces, models, entities)
+- Property counts and types
+- Association mappings
+- Semantic annotation usage
+- UI presentation information
+
+## Generating Metadata
+
+Each template needs to be processed to generate metadata files. These metadata are used to generate the templates view in the UI.
+
+**If you won't generate metadata, the template won't get registered by the UI.**
+
+### 1. Build the Project First
+
+```sh
+npm run build
+```
+
+### 2. Run the Metadata Generation Script
+
+```sh
+node scripts/generate-template-metadata.js
+```
+
+### 3. Rebuild to Include New Metadata
+
+```sh
+npm run build
+```
+
+All metadata are generated under `src/modeling/templates/meta` directory as JSON files.
+
+## Best Practices
+
+### Domain Design
+
+1. **Business Alignment**: Model actual business processes and entities
+2. **Clear Naming**: Use business-meaningful names, not technical jargon
+3. **Proper Grouping**: Organize entities into logical namespaces and models
+4. **Semantic Richness**: Apply appropriate semantic annotations for security and behavior
+
+### Code Quality
+
+1. **Documentation**: Include comprehensive JSDoc comments explaining the business purpose
+2. **Type Safety**: Use TypeScript interfaces and proper type annotations
+3. **Error Handling**: Validate inputs and provide clear error messages
+4. **Consistency**: Use helper functions from `helpers/Intelisense.js` for common patterns
+
+### Security
+
+1. **Sensitive Data**: Mark passwords and sensitive fields as `writeOnly`
+2. **Validation**: Validate all user inputs and model structures
+3. **Access Control**: Consider data access patterns in your domain design
+
+## Example Templates
+
+Refer to existing templates for comprehensive examples:
+
+- `ecommerce-domain.ts` - E-commerce platform with users, products, orders
+- `blog-domain.ts` - Content management with publishing workflow
+
+These demonstrate proper structure, semantic usage, and business modeling patterns.

package/src/modeling/templates/template-registry.ts

@@ -0,0 +1,67 @@
+import type { DomainTemplate } from './types.js'
+import {
+  getAllTemplates,
+  getTemplate,
+  getTemplatesByTag,
+  getTemplatesByCategory,
+  searchTemplates,
+  getTemplateStats,
+} from './meta/index.js'
+
+/**
+ * Registry of all available domain templates with their metadata.
+ * This provides a central location for UI components to discover and present templates.
+ *
+ * The templates are pre-processed at build time using the generate-template-metadata.js script
+ * to avoid loading and processing all templates on the client side.
+ */
+// eslint-disable-next-line @typescript-eslint/no-extraneous-class
+export class TemplateRegistry {
+  /**
+   * Gets all available templates
+   */
+  static getAllTemplates(): DomainTemplate[] {
+    return getAllTemplates()
+  }
+
+  /**
+   * Gets a template by its ID
+   */
+  static getTemplate(id: string): DomainTemplate | undefined {
+    return getTemplate(id)
+  }
+
+  /**
+   * Gets templates filtered by tags
+   */
+  static getTemplatesByTag(tag: string): DomainTemplate[] {
+    return getTemplatesByTag(tag)
+  }
+
+  /**
+   * Gets templates filtered by category (based on tags)
+   */
+  static getTemplatesByCategory(category: 'business' | 'content' | 'social' | 'technical'): DomainTemplate[] {
+    return getTemplatesByCategory(category)
+  }
+
+  /**
+   * Searches templates by name or description
+   */
+  static searchTemplates(query: string): DomainTemplate[] {
+    return searchTemplates(query)
+  }
+
+  /**
+   * Gets template statistics for analytics
+   */
+  static getTemplateStats(): {
+    totalTemplates: number
+    totalEntities: number
+    totalProperties: number
+    totalAssociations: number
+    categoryCounts: Record<string, number>
+  } {
+    return getTemplateStats()
+  }
+}