@api-client/core 0.18.26 → 0.18.28

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

@@ -42068,10 +42068,10 @@
 "@id": "#194"
 },
 {
-"@id": "#200"
+"@id": "#197"
 },
 {
-"@id": "#197"
+"@id": "#200"
 },
 {
 "@id": "#203"
@@ -43478,7 +43478,7 @@
 "doc:ExternalDomainElement",
 "doc:DomainElement"
 ],
-"doc:raw": "class: '3'\ndescription: '150 - 300'\nnumberOfFte: 5500\nnumberOfEmployees: 5232\n",
+"doc:raw": "code: '5'\ndescription: 'Limited company'\n",
 "core:mediaType": "application/yaml",
 "sourcemaps:sources": [
 {
@@ -43499,7 +43499,7 @@
 "doc:ExternalDomainElement",
 "doc:DomainElement"
 ],
-"doc:raw": "code: '5'\ndescription: 'Limited company'\n",
+"doc:raw": "class: '3'\ndescription: '150 - 300'\nnumberOfFte: 5500\nnumberOfEmployees: 5232\n",
 "core:mediaType": "application/yaml",
 "sourcemaps:sources": [
 {
@@ -44766,12 +44766,12 @@
 {
 "@id": "#199/source-map/lexical/element_0",
 "sourcemaps:element": "amf://id#199",
-"sourcemaps:value": "[(1,0)-(5,0)]"
+"sourcemaps:value": "[(1,0)-(3,0)]"
 },
 {
 "@id": "#202/source-map/lexical/element_0",
 "sourcemaps:element": "amf://id#202",
-"sourcemaps:value": "[(1,0)-(3,0)]"
+"sourcemaps:value": "[(1,0)-(5,0)]"
 },
 {
 "@id": "#205/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.26",
+  "version": "0.18.28",
   "license": "Apache-2.0",
   "exports": {
     "./browser.js": {
@@ -87,6 +87,7 @@
     "@api-client/graph": "^0.3.5",
     "@api-client/json": "^0.2.0",
     "@esm-bundle/chai": "^4.3.4-fix.0",
+    "@jarrodek/pluralize": "^1.0.2",
     "@metrichor/jmespath": "^0.3.1",
     "@pawel-up/csv": "^0.2.0",
     "@pawel-up/data-mock": "^0.4.0",

package/src/modeling/ApiModel.ts

@@ -11,10 +11,13 @@ import type {
   RolesBasedAccessControl,
   SessionConfiguration,
   UsernamePasswordConfiguration,
+  ExposeOptions,
 } from './types.js'
 import { DataDomain } from './DataDomain.js'
 import { DependentModel, type DependentModelSchema, type DomainDependency } from './DependentModel.js'
 import { observed, toRaw } from '../decorators/observed.js'
+import pluralize from '@jarrodek/pluralize'
+import { createDomainKey } from './helpers/keying.js'
 
 /**
  * Contact information for the exposed API.
@@ -54,12 +57,12 @@ export interface ApiModelSchema extends DependentModelSchema {
    */
   kind: typeof ApiModelKind
   /**
-   * The unique key of the data domain schema.
+   * The unique key of the API model schema.
    * This is a stable identifier that does not change across versions.
    */
   key: string
   /**
-   * Contains the name, display name, description, and the version of the data domain schema.
+   * Contains the name, display name, description, and the version of the API model schema.
    */
   info: IThing
 
@@ -376,41 +379,182 @@ export class ApiModel extends DependentModel {
   /**
    * Exposes a new entity in the API model.
    * If the entity already exists, it returns the existing one.
-   * @param entityKey The key of the entity to expose.
+   * @param entity The entity key and domain to expose.
    * @returns The exposed entity.
    */
-  exposeEntity(entityKey: string): ExposedEntity {
-    const existing = this.exposes.find((e) => e.key === entityKey)
+  exposeEntity(entity: AssociationTarget, options?: ExposeOptions): ExposedEntity {
+    const domain = this.domain
+    if (!domain) {
+      throw new Error(`No domain attached to API model`)
+    }
+    // checks whether the entity is already exposed as a root exposure.
+    const existing = this.exposes.find(
+      (e) => e.isRoot && e.entity.key === entity.key && e.entity.domain === entity.domain
+    )
     if (existing) {
+      // quietly return the existing exposure
+      // TBD: should we throw an error here?
       return existing
     }
+    const domainEntity = domain.findEntity(entity.key, entity.domain)
+    if (!domainEntity) {
+      throw new Error(`Entity not found in domain: ${entity.key}`)
+    }
+    const name = domainEntity.info.name || ''
     const newEntity: ExposedEntity = {
-      key: entityKey,
+      key: nanoid(),
+      entity: { ...entity },
       actions: [],
+      isRoot: true,
+      path: pluralize(name.toLocaleLowerCase()),
+    }
+    if (options) {
+      newEntity.exposeOptions = { ...options }
     }
     this.exposes.push(newEntity)
+
+    // Follow associations if requested
+    if (options?.followAssociations) {
+      if (options?.maxDepth === undefined || options.maxDepth > 0) {
+        this.followEntityAssociations(newEntity, options)
+      }
+    }
     this.notifyChange()
     return newEntity
   }
 
   /**
-   * Removes an entity from the API model.
-   * @param entityKey The key of the entity to remove.
+   * Follows associations for a newly exposed entity if configured to do so.
+   * This creates nested exposures based on the entity's associations.
+   *
+   * @param parentExposure The root exposure to follow associations from
+   * @param options The expose options containing follow configuration
    */
-  removeEntity(entityKey: string): void {
-    const index = this.exposes.findIndex((e) => e.key === entityKey)
-    if (index !== -1) {
-      this.exposes.splice(index, 1)
-      this.notifyChange()
+  private followEntityAssociations(parentExposure: ExposedEntity, options: ExposeOptions): void {
+    const domain = this.domain
+    if (!domain) {
+      return
+    }
+    const maxDepth = options.maxDepth ?? 6
+    const visited = new Set<string>()
+    // Add parent entity's key to the visited set so we won't skip it when traversing
+    // associations.
+    visited.add(createDomainKey(parentExposure.entity))
+
+    const follow = (currentEntity: AssociationTarget, parentKey: string, depth: number) => {
+      // Find the domain entity
+      const domainEntity = domain.findEntity(currentEntity.key, currentEntity.domain)
+      if (!domainEntity) return
+
+      // Iterate through associations
+      for (const association of domainEntity.listAssociations()) {
+        for (const target of association.targets) {
+          // Skip self-referencing associations
+          if (target.key === currentEntity.key && target.domain === currentEntity.domain) {
+            continue
+          }
+
+          // Create unique identifier for circular detection
+          const visitKey = createDomainKey(target)
+          if (visited.has(visitKey)) {
+            continue // Skip circular references
+          }
+          visited.add(visitKey)
+
+          // Check if this nested exposure already exists
+          const existingNested = this.exposes.find(
+            (e) =>
+              !e.isRoot &&
+              e.entity.key === target.key &&
+              e.entity.domain === target.domain &&
+              e.parent?.key === parentKey
+          )
+
+          if (existingNested) {
+            continue // Already exposed under this parent
+          }
+
+          // Find the target domain entity for path generation
+          const targetDomainEntity = domain.findEntity(target.key, target.domain)
+          if (!targetDomainEntity) continue
+
+          const name = association.info.name || ''
+          // Create nested exposure
+          const nestedExposure: ExposedEntity = {
+            key: nanoid(),
+            entity: { ...target },
+            actions: [],
+            isRoot: false,
+            path: pluralize(name.toLocaleLowerCase()),
+            parent: {
+              key: parentKey,
+              association: {
+                key: association.key,
+                domain: currentEntity.domain,
+              },
+              depth: depth + 1,
+            },
+          }
+
+          this.exposes.push(nestedExposure)
+          if (depth + 1 >= maxDepth) {
+            nestedExposure.truncated = true
+          } else {
+            // Recursively follow associations
+            follow(target, nestedExposure.key, depth + 1)
+          }
+        }
+      }
+    }
+
+    // Start following from the root exposure
+    follow(parentExposure.entity, parentExposure.key, 0)
+  }
+
+  /**
+   * Removes an exposed entity from the API model.
+   * @param entity The entity to remove.
+   */
+  removeEntity(entity: AssociationTarget): void {
+    const current = this.exposes.find((e) => e.entity.key === entity.key && e.entity.domain === entity.domain)
+    if (!current) {
+      return
+    }
+    this.removeWithChildren(current.key)
+    this.notifyChange()
+  }
+
+  private removeWithChildren(key: string): void {
+    const index = this.exposes.findIndex((e) => e.key === key)
+    if (index < 0) {
+      return
     }
+    // Remove the parent itself
+    this.exposes.splice(index, 1)
+    // Remove all children recursively
+    const removeChildren = (parentKey: string) => {
+      // Find all exposures whose parent.key matches parentKey
+      const children = this.exposes.filter((e) => e.parent?.key === parentKey)
+      for (const child of children) {
+        removeChildren(child.key)
+        const childIndex = this.exposes.findIndex((e) => e.key === child.key)
+        if (childIndex >= 0) {
+          this.exposes.splice(childIndex, 1)
+        }
+      }
+    }
+    // Then also remove children
+    removeChildren(key)
+    this.notifyChange()
   }
+
   /**
    * Returns the exposed entity by its key.
    * @param entityKey The key of the entity to find.
    * @returns The exposed entity or undefined if not found.
    */
-  getExposedEntity(entityKey: string): ExposedEntity | undefined {
-    return this.exposes.find((e) => e.key === entityKey)
+  getExposedEntity(entity: AssociationTarget): ExposedEntity | undefined {
+    return this.exposes.find((e) => e.entity.key === entity.key && e.entity.domain === entity.domain)
   }
 
   /**

package/src/modeling/Semantics.ts

@@ -26,6 +26,13 @@ export enum SemanticType {
    * ensuring it is encrypted and not exposed in API responses.
    */
   Password = 'Semantic#Password',
+  /**
+   * Annotates the field as the username for user authentication.
+   * This identifies which field should be used for login purposes.
+   * Can be applied to dedicated username fields or email fields that serve as usernames.
+   * The runtime uses this for authentication, password reset, and user lookup operations.
+   */
+  Username = 'Semantic#Username',
   /**
    * Designates a Data Property as the `createdAt` timestamp of an entity.
    * This is used to track when the entity was first created.
@@ -651,6 +658,22 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
       ],
     },
   },
+  [SemanticType.Username]: {
+    id: SemanticType.Username,
+    displayName: 'Username',
+    scope: SemanticScope.Property,
+    description: 'User authentication identifier',
+    category: SemanticCategory.Identity,
+    applicableDataTypes: ['string'],
+    hasConfig: false,
+    runtime: {
+      timing: SemanticTiming.Before,
+      operations: [SemanticOperation.Create, SemanticOperation.Update, SemanticOperation.Read],
+      priority: 15, // High priority for authentication
+      canDisable: false, // Security semantics cannot be disabled
+      timeoutMs: 100, // Fast operation
+    },
+  },
   [SemanticType.UserRole]: {
     id: SemanticType.UserRole,
     displayName: 'User Role Field',

package/src/modeling/helpers/endpointHelpers.ts

@@ -0,0 +1,5 @@
+export function paramNameFor(entityKeyLocal: string): string {
+  const parts = entityKeyLocal.split(':')
+  const key = parts[parts.length - 1]
+  return `${key}Id`
+}

package/src/modeling/helpers/keying.ts

@@ -0,0 +1,11 @@
+import { AssociationTarget } from '../types.js'
+
+/**
+ * Creates a consistent key for a given association target within its domain.
+ *
+ * @param target The association target to create a key for.
+ * @returns A unique key for the association target.
+ */
+export function createDomainKey(target: AssociationTarget): string {
+  return target.domain ? `${target.domain}:${target.key}` : target.key
+}

package/src/modeling/readme.md

@@ -122,13 +122,159 @@ Let's imagine a simple e-commerce domain:
 - **Entity-Parent**: A `DomainEntity` can have `DomainEntity` instances as parents.
 - **Namespace-Foreign**: A `DomainNamespace` can have references to `DomainNamespace` instances.
 
+## API Modeling
+
+Beyond data modeling, the system also provides **API Modeling** capabilities that allow you to define how your data domain is exposed as a secure, production-ready API.
+
+### ApiModel
+
+The `ApiModel` class extends the data modeling system to define how Data Entities from a `DataDomain` are exposed via HTTP APIs. It provides configuration for:
+
+**Core API Configuration:**
+
+- **Exposed Entities**: Select which Data Entities from your Data Domain should be accessible via the API
+- **API Actions**: Define what operations (List, Read, Create, Update, Delete, Search) are available for each entity
+- **User Entity**: Designate which Data Entity represents a "User" for authentication purposes
+
+**Security & Authentication:**
+
+- **Authentication**: Configure how users prove their identity (e.g., username/password)
+- **Authorization**: Define what authenticated users are allowed to do (e.g., Role-Based Access Control)
+- **Session Management**: Configure transport and payload for user sessions (JWT, cookies)
+- **Access Rules**: Define fine-grained access control policies for entities and actions
+
+**API Metadata:**
+
+- **Contact Information**: API maintainer details
+- **License Information**: Legal information about API usage
+- **Terms of Service**: Link to API usage terms
+- **Rate Limiting**: Protect the API from overuse and abuse
+
+### How API Modeling Works with Data Modeling
+
+The API modeling system builds on top of the data modeling foundation:
+
+1. **Start with a Data Domain**: Create your `DataDomain` with entities, properties, and associations
+2. **Create an API Model**: Instantiate an `ApiModel` and attach your `DataDomain`
+3. **Expose Entities**: Select which entities should be available via the API using `exposeEntity()`
+4. **Configure Security**: Set up authentication, authorization, and session management
+5. **Define Actions**: Configure what operations are available for each exposed entity
+6. **Set API Metadata**: Add contact info, license, terms of service
+
+### Example: E-Commerce API
+
+Building on the e-commerce data domain example:
+
+```typescript
+// 1. Create the data domain (as shown in previous example)
+const domain = new DataDomain({ key: 'ecommerce', info: { name: 'E-Commerce Platform' } })
+const userModel = domain.addModel({ info: { name: 'User Management' } })
+const userEntity = userModel.addEntity({ 
+  info: { name: 'user' },
+  semantics: [{ type: SemanticType.User }] // Mark as User entity
+})
+
+// 2. Create an API model
+const apiModel = new ApiModel({
+  info: { name: 'E-Commerce API', version: '1.0.0' },
+  termsOfService: 'https://example.com/terms',
+  contact: { name: 'API Team', email: 'api@example.com' },
+  license: { name: 'MIT', url: 'https://opensource.org/licenses/MIT' }
+})
+
+// 3. Attach the data domain
+apiModel.attachDataDomain(domain)
+
+// 4. Configure security
+apiModel.user = { key: userEntity.key }
+apiModel.authentication = { strategy: 'UsernamePassword', passwordKey: 'password' }
+apiModel.authorization = { strategy: 'RBAC', roleKey: 'role' }
+apiModel.session = { 
+  secret: 'your-secure-secret',
+  properties: ['email', 'role'],
+  cookie: { enabled: true, kind: 'cookie', lifetime: '7d' }
+}
+
+// 5. Expose entities and configure actions
+const exposedUser = apiModel.exposeEntity(userEntity.key)
+exposedUser.actions = [
+  { type: 'Read', enabled: true },
+  { type: 'Update', enabled: true },
+  { type: 'Create', enabled: true }
+]
+```
+
+### Key API Modeling Concepts
+
+#### ExposedEntity
+
+Represents a Data Entity that is exposed via the API. Contains:
+
+- **Key**: Reference to the Data Entity
+- **Actions**: List of available API operations (CRUD, Search)
+- **Access Rules**: Entity-specific access control
+- **Rate Limiting**: Entity-specific rate limiting rules
+
+#### API Actions
+
+Standard RESTful operations that can be enabled for each entity:
+
+- **List**: Retrieve collections of entities with filtering and pagination
+- **Read**: Retrieve a single entity by ID
+- **Create**: Create new entities
+- **Update**: Modify existing entities
+- **Delete**: Remove entities
+- **Search**: Full-text or advanced search across entities
+
+#### Authentication Configuration
+
+Defines how users prove their identity:
+
+- **UsernamePassword**: Traditional email/password authentication
+- Extensible for future strategies (SSO, OAuth, etc.)
+
+#### Authorization Configuration
+
+Defines what authenticated users can do:
+
+- **RBAC (Role-Based Access Control)**: Users have roles, permissions granted to roles
+- Extensible for future strategies (PBAC - Permission-Based Access Control)
+
+#### Session Configuration
+
+Manages user session data:
+
+- **Properties**: Which User entity properties to include in session
+- **Transport**: How session data is transmitted (JWT tokens, cookies)
+- **Security**: Encryption, lifetime, and security settings
+
+### Business-First API Design
+
+The API modeling system follows the same business-first philosophy as data modeling:
+
+- **Semantic Awareness**: Uses semantic types to automatically configure security (e.g., Password properties are write-only)
+- **Standard Compliance**: Generates OpenAPI-compliant specifications
+- **Security by Default**: Requires explicit configuration for authentication, authorization, and sessions
+- **User-Friendly**: Clear error messages and validation feedback
+- **Production Ready**: Built-in support for rate limiting, access control, and monitoring
+
 ## Summary
 
-This data modeling system provides a flexible and powerful way to define complex data domains. It allows you to:
+This comprehensive modeling system provides both **Data Modeling** and **API Modeling** capabilities:
+
+**Data Modeling** allows you to:
+
+- **Organize**: Group related data into namespaces and models
+- **Structure**: Define entities with properties and relationships
+- **Reuse**: Inherit from other entities and reference foreign namespaces
+- **Translate**: Define bindings to map the model to different formats
+- **Validate**: Validate the data model definition
+- **Generate**: Generate AMF shapes and examples
+
+**API Modeling** extends this to:
 
-- **Organize**: Group related data into namespaces and models.
-- **Structure**: Define entities with properties and relationships.
-- **Reuse**: Inherit from other entities and reference foreign namespaces.
-- **Translate**: Define bindings to map the model to different formats.
-- **Validate**: Validate the data model definition.
-- **Generate**: Generate AMF shapes and examples.
+- **Expose**: Selectively expose Data Entities as API resources
+- **Secure**: Configure authentication, authorization, and session management
+- **Control**: Define fine-grained access rules and rate limiting
+- **Document**: Generate complete API documentation with business context
+- **Deploy**: Create production-ready APIs with proper security and monitoring

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

@@ -1 +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":69,"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":7,"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":"ip_address","displayName":"IP Address","description":"Visitor IP address","type":"string","semantics":["Semantic#ClientIPAddress"]},{"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":[]}]}]}]}}
+{"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":70,"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":14,"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#UserRole"],"enumValues":["subscriber","author","editor","admin","super_admin"],"defaultValue":"subscriber"},{"name":"status","displayName":"User Status","description":"Current status of the user account","type":"string","required":true,"semantics":["Semantic#Status"],"enumValues":["active","inactive","suspended","pending_verification"],"defaultValue":"active"},{"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":7,"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":"ip_address","displayName":"IP Address","description":"Visitor IP address","type":"string","semantics":["Semantic#ClientIPAddress"]},{"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":[]}]}]}]}}