@api-client/core 0.18.55 → 0.18.57

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

@@ -42062,13 +42062,13 @@
 "@id": "#209"
 },
 {
-"@id": "#191"
+"@id": "#194"
 },
 {
-"@id": "#197"
+"@id": "#191"
 },
 {
-"@id": "#194"
+"@id": "#197"
 },
 {
 "@id": "#200"
@@ -42816,10 +42816,10 @@
 "@id": "#213"
 },
 {
-"@id": "#219"
+"@id": "#216"
 },
 {
-"@id": "#216"
+"@id": "#219"
 }
 ],
 "doc:root": false,
@@ -43436,7 +43436,7 @@
 "doc:ExternalDomainElement",
 "doc:DomainElement"
 ],
-"doc:raw": "countryCode: \"BE\"\ngraydonEnterpriseId: 1057155523\nregistrationId: \"0422319093\"\nvatNumber: \"BE0422319093\"\ngraydonCompanyId: \"0422319093\"\nisBranchOffice: false\n",
+"doc:raw": "addressType: 'REGISTERED-OFFICE-ADDRESS'\nstreetName: 'UITBREIDINGSTRAAT'\nhouseNumber: '84'\nhouseNumberAddition: '/1'\npostalCode: '2600'\ncity: 'BERCHEM (ANTWERPEN)'\ncountry: 'Belgium'\ncountryCode: 'BE'\nfullFormatedAddress: \"UITBREIDINGSTRAAT 84 /1, 2600 BERCHEM (ANTWERPEN), BELIUM\"\n",
 "core:mediaType": "application/yaml",
 "sourcemaps:sources": [
 {
@@ -43457,7 +43457,7 @@
 "doc:ExternalDomainElement",
 "doc:DomainElement"
 ],
-"doc:raw": "code: '5'\ndescription: 'Limited company'\n",
+"doc:raw": "countryCode: \"BE\"\ngraydonEnterpriseId: 1057155523\nregistrationId: \"0422319093\"\nvatNumber: \"BE0422319093\"\ngraydonCompanyId: \"0422319093\"\nisBranchOffice: false\n",
 "core:mediaType": "application/yaml",
 "sourcemaps:sources": [
 {
@@ -43478,7 +43478,7 @@
 "doc:ExternalDomainElement",
 "doc:DomainElement"
 ],
-"doc:raw": "addressType: 'REGISTERED-OFFICE-ADDRESS'\nstreetName: 'UITBREIDINGSTRAAT'\nhouseNumber: '84'\nhouseNumberAddition: '/1'\npostalCode: '2600'\ncity: 'BERCHEM (ANTWERPEN)'\ncountry: 'Belgium'\ncountryCode: 'BE'\nfullFormatedAddress: \"UITBREIDINGSTRAAT 84 /1, 2600 BERCHEM (ANTWERPEN), BELIUM\"\n",
+"doc:raw": "code: '5'\ndescription: 'Limited company'\n",
 "core:mediaType": "application/yaml",
 "sourcemaps:sources": [
 {
@@ -44274,7 +44274,7 @@
 "doc:ExternalDomainElement",
 "doc:DomainElement"
 ],
-"doc:raw": "type: \"GENERAL\"\nvalue: \"www.company.be\"\n",
+"doc:raw": "-\n  type: 'GENERAL'\n  value: 'info@company.be'\n-\n  type: 'IT_DEPT'\n  value: 'it-service@company.be'\n",
 "core:mediaType": "application/yaml",
 "sourcemaps:sources": [
 {
@@ -44295,7 +44295,7 @@
 "doc:ExternalDomainElement",
 "doc:DomainElement"
 ],
-"doc:raw": "-\n  type: 'GENERAL'\n  value: 'info@company.be'\n-\n  type: 'IT_DEPT'\n  value: 'it-service@company.be'\n",
+"doc:raw": "type: \"GENERAL\"\nvalue: \"www.company.be\"\n",
 "core:mediaType": "application/yaml",
 "sourcemaps:sources": [
 {
@@ -44756,17 +44756,17 @@
 {
 "@id": "#193/source-map/lexical/element_0",
 "sourcemaps:element": "amf://id#193",
-"sourcemaps:value": "[(1,0)-(7,0)]"
+"sourcemaps:value": "[(1,0)-(10,0)]"
 },
 {
 "@id": "#196/source-map/lexical/element_0",
 "sourcemaps:element": "amf://id#196",
-"sourcemaps:value": "[(1,0)-(3,0)]"
+"sourcemaps:value": "[(1,0)-(7,0)]"
 },
 {
 "@id": "#199/source-map/lexical/element_0",
 "sourcemaps:element": "amf://id#199",
-"sourcemaps:value": "[(1,0)-(10,0)]"
+"sourcemaps:value": "[(1,0)-(3,0)]"
 },
 {
 "@id": "#202/source-map/lexical/element_0",
@@ -45126,12 +45126,12 @@
 {
 "@id": "#218/source-map/lexical/element_0",
 "sourcemaps:element": "amf://id#218",
-"sourcemaps:value": "[(1,0)-(3,0)]"
+"sourcemaps:value": "[(1,0)-(7,0)]"
 },
 {
 "@id": "#221/source-map/lexical/element_0",
 "sourcemaps:element": "amf://id#221",
-"sourcemaps:value": "[(1,0)-(7,0)]"
+"sourcemaps:value": "[(1,0)-(3,0)]"
 },
 {
 "@id": "#338/source-map/synthesized-field/element_1",

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.55",
+  "version": "0.18.57",
   "license": "Apache-2.0",
   "exports": {
     "./browser.js": {
@@ -288,14 +288,9 @@
       "command": "prettier \"**/*.ts\" --write"
     }
   },
-  "husky": {
-    "hooks": {
-      "pre-commit": "lint-staged"
-    }
-  },
   "lint-staged": {
     "*.ts": [
-      "eslint --fix"
+      "npm run format"
     ]
   },
   "engines": {

package/src/modeling/Semantics.ts

@@ -886,7 +886,7 @@ export const DataSemantics: Record<SemanticType, DataSemantic> = {
     description: 'Postal or zip code',
     category: SemanticCategory.Contact,
     applicableDataTypes: ['string'],
-    hasConfig: false,
+    hasConfig: true,
     runtime: {
       timing: SemanticTiming.None,
       operations: [],

package/src/modeling/helpers/Intelisense.ts

@@ -87,6 +87,8 @@ export function addAutoField(entity: DomainEntity, autoField: string): DomainEle
       return addUnitPriceField(entity)
     case 'street-address':
       return addStreetAddressField(entity)
+    case 'street-address-supplemental':
+      return addStreetAddressSupplementalField(entity)
     case 'city':
       return addCityField(entity)
     case 'postal-code':
@@ -1391,6 +1393,27 @@ function findStreetAddressField(entity: DomainEntity, direct = false): DomainPro
   return findPropertyField(entity, (property) => property.hasSemantic(SemanticType.StreetAddress), direct)
 }
 
+export function addStreetAddressSupplementalField(entity: DomainEntity, info: Partial<IThing> = {}): DomainProperty {
+  // we do not look for duplicates here, because the address can have multiple supplements (like line2, line3, etc.)
+  let latest = 0
+  for (const prop of entity.properties) {
+    if (prop.hasSemantic(SemanticType.StreetAddressSupplemental)) {
+      const match = prop.info.name?.match(/street_address_(\d+)/)
+      if (match) {
+        const num = parseInt(match[1], 10)
+        if (num > latest) latest = num
+      }
+    }
+  }
+  const prop = entity.addProperty({
+    info: { name: `street_address_${latest + 1}`, displayName: `Street Address ${latest + 1}`, ...info },
+    type: 'string',
+    required: false,
+  })
+  prop.addSemantic({ id: SemanticType.StreetAddressSupplemental })
+  return prop
+}
+
 export function addCityField(entity: DomainEntity, info: Partial<IThing> = {}): DomainProperty {
   const existing = findCityField(entity, true)
   if (existing) return existing

package/tests/unit/modeling/helpers/intellisense.spec.ts

@@ -39,6 +39,7 @@ import {
   addStreetAddressField,
   addCityField,
   addRegionField,
+  addStreetAddressSupplementalField,
 } from '../../../../src/modeling/helpers/Intelisense.js'
 import { SemanticType } from '../../../../src/modeling/Semantics.js'
 import { createCountrySemantic } from '../../../../src/modeling/definitions/Country.js'
@@ -1237,3 +1238,48 @@ test.group('addRegionField()', () => {
     assert.equal(field.info.description, 'Region XXX')
   })
 })
+
+test.group('addStreetAddressSupplementalField()', () => {
+  test('creates first supplemental field when none exists', ({ assert }) => {
+    const entity = createTestEntity()
+    const field = addStreetAddressSupplementalField(entity)
+    assert.instanceOf(field, DomainProperty)
+    assert.equal(field.info.name, 'street_address_1')
+    assert.equal(field.info.displayName, 'Street Address 1')
+    assert.equal(field.type, 'string')
+    assert.isFalse(field.required)
+    assert.isTrue(field.hasSemantic(SemanticType.StreetAddressSupplemental))
+  })
+
+  test('increments supplemental field index', ({ assert }) => {
+    const entity = createTestEntity()
+    const field1 = addStreetAddressSupplementalField(entity)
+    const field2 = addStreetAddressSupplementalField(entity)
+
+    assert.equal(field1.info.name, 'street_address_1')
+    assert.equal(field2.info.name, 'street_address_2')
+    assert.equal(field2.info.displayName, 'Street Address 2')
+  })
+
+  test('handles gaps in numbering', ({ assert }) => {
+    const entity = createTestEntity()
+    // Manually add a field mimicking a higher number
+    const manualField = entity.addProperty({
+      info: { name: 'street_address_5', displayName: 'Street Address 5' },
+      type: 'string',
+      required: false,
+    })
+    manualField.addSemantic({ id: SemanticType.StreetAddressSupplemental })
+
+    const field = addStreetAddressSupplementalField(entity)
+    assert.equal(field.info.name, 'street_address_6')
+    assert.equal(field.info.displayName, 'Street Address 6')
+  })
+
+  test('merges custom info', ({ assert }) => {
+    const entity = createTestEntity()
+    const field = addStreetAddressSupplementalField(entity, { description: 'Extra line' })
+    assert.equal(field.info.name, 'street_address_1')
+    assert.equal(field.info.description, 'Extra line')
+  })
+})

package/build/src/modeling/templates/index.d.ts

@@ -1,21 +0,0 @@
-import type { DataDomain } from '../DataDomain.js';
-import type { DomainTemplate, DomainTemplateStructure } from './types.js';
-export * from './verticals/index.js';
-/**
- * Creates template metadata from a DataDomain instance for UI presentation
- */
-export declare function createTemplateMetadata(domain: DataDomain, templateInfo: {
-    id: string;
-    name: string;
-    description: string;
-    version: string;
-    author: string;
-    tags?: string[];
-    createdAt: string;
-    updatedAt: string;
-}): DomainTemplate;
-/**
- * Analyzes a DataDomain to extract structural information for UI presentation
- */
-export declare function analyzeDomainStructure(domain: DataDomain): DomainTemplateStructure;
-//# sourceMappingURL=index.d.ts.map

package/build/src/modeling/templates/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modeling/templates/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAMlD,OAAO,KAAK,EAEV,cAAc,EACd,uBAAuB,EAKxB,MAAM,YAAY,CAAA;AAGnB,cAAc,sBAAsB,CAAA;AAEpC;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,UAAU,EAClB,YAAY,EAAE;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB,GACA,cAAc,CAchB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU,GAAG,uBAAuB,CAgClF"}

package/build/src/modeling/templates/index.js

@@ -1,176 +0,0 @@
-// Import vertical organization
-export * from './verticals/index.js';
-/**
- * Creates template metadata from a DataDomain instance for UI presentation
- */
-export function createTemplateMetadata(domain, templateInfo) {
-    const structure = analyzeDomainStructure(domain);
-    return {
-        id: templateInfo.id,
-        name: templateInfo.name,
-        description: templateInfo.description,
-        createdAt: templateInfo.createdAt,
-        updatedAt: templateInfo.updatedAt,
-        version: templateInfo.version,
-        author: templateInfo.author,
-        tags: templateInfo.tags || [],
-        structure,
-    };
-}
-/**
- * Analyzes a DataDomain to extract structural information for UI presentation
- */
-export function analyzeDomainStructure(domain) {
-    const namespaces = [];
-    let totalEntities = 0;
-    let totalProperties = 0;
-    let totalAssociations = 0;
-    // Analyze each namespace
-    for (const namespace of domain.listNamespaces()) {
-        const namespaceInfo = analyzeNamespace(namespace);
-        namespaces.push(namespaceInfo);
-        totalEntities += namespaceInfo.entityCount;
-        totalProperties += namespaceInfo.models.reduce((sum, model) => sum + model.entities.reduce((entitySum, entity) => entitySum + entity.propertyCount, 0), 0);
-        totalAssociations += namespaceInfo.models.reduce((sum, model) => sum + model.entities.reduce((entitySum, entity) => entitySum + entity.associationCount, 0), 0);
-    }
-    return {
-        domain: {
-            name: domain.info.name || 'Unnamed Domain',
-            description: domain.info.description,
-            totalEntities,
-            totalProperties,
-            totalAssociations,
-        },
-        namespaces,
-    };
-}
-/**
- * Analyzes a DomainNamespace to extract information for UI presentation
- */
-function analyzeNamespace(namespace) {
-    const models = [];
-    let entityCount = 0;
-    // Analyze each model in the namespace
-    for (const model of namespace.listModels()) {
-        const modelInfo = analyzeModel(model);
-        models.push(modelInfo);
-        entityCount += modelInfo.entityCount;
-    }
-    return {
-        name: namespace.info.name || 'Unnamed Namespace',
-        displayName: namespace.info.displayName,
-        description: namespace.info.description,
-        modelCount: models.length,
-        entityCount,
-        models,
-    };
-}
-/**
- * Analyzes a DomainModel to extract information for UI presentation
- */
-function analyzeModel(model) {
-    const entities = [];
-    // Analyze each entity in the model
-    for (const entity of model.listEntities()) {
-        const entityInfo = analyzeEntity(entity);
-        entities.push(entityInfo);
-    }
-    return {
-        name: model.info.name || 'Unnamed Model',
-        displayName: model.info.displayName,
-        description: model.info.description,
-        entityCount: entities.length,
-        entities,
-    };
-}
-/**
- * Analyzes a DomainEntity to extract information for UI presentation
- */
-function analyzeEntity(entity) {
-    const properties = [];
-    const associations = [];
-    // Analyze properties
-    for (const property of entity.listProperties()) {
-        properties.push(analyzeProperty(property));
-    }
-    // Analyze associations
-    for (const association of entity.listAssociations()) {
-        associations.push(analyzeAssociation(association));
-    }
-    return {
-        name: entity.info.name || 'Unnamed Entity',
-        displayName: entity.info.displayName,
-        description: entity.info.description,
-        propertyCount: properties.length,
-        associationCount: associations.length,
-        deprecated: entity.deprecated,
-        properties,
-        associations,
-        semantics: entity.semantics?.map((s) => s.id) || [],
-    };
-}
-/**
- * Analyzes a DomainProperty to extract information for UI presentation
- */
-function analyzeProperty(property) {
-    const semantics = property.semantics?.map((s) => s.id) || [];
-    // Extract enum values if present
-    let enumValues;
-    if (property.schema?.enum && Array.isArray(property.schema.enum)) {
-        enumValues = property.schema.enum.map((v) => String(v));
-    }
-    // Extract default value
-    let defaultValue;
-    if (property.schema?.defaultValue) {
-        if (property.schema.defaultValue.type === 'literal') {
-            defaultValue = String(property.schema.defaultValue.value);
-        }
-    }
-    return {
-        name: property.info.name || 'Unnamed Property',
-        displayName: property.info.displayName,
-        description: property.info.description,
-        type: property.type || 'string',
-        required: property.required,
-        multiple: property.multiple,
-        primary: property.primary,
-        unique: property.unique,
-        readOnly: property.readOnly,
-        writeOnly: property.writeOnly,
-        deprecated: property.deprecated,
-        semantics,
-        enumValues,
-        defaultValue,
-    };
-}
-/**
- * Analyzes a DomainAssociation to extract information for UI presentation
- */
-function analyzeAssociation(association) {
-    const semantics = association.semantics?.map((s) => s.id) || [];
-    // Get target entity names
-    const targetEntities = association.targets?.map((target) => {
-        // Try to resolve the target entity to get its name
-        const targetEntity = association.domain.findEntity(target.key);
-        return targetEntity?.info.name || target.key;
-    }) || [];
-    // Determine cardinality description
-    let cardinality = 'One-to-One';
-    if (association.multiple) {
-        cardinality = 'One-to-Many';
-    }
-    // Note: Many-to-Many would typically be determined by looking at the reverse association
-    // but for simplicity in UI presentation, we'll use the current association's multiplicity
-    return {
-        name: association.info.name || 'Unnamed Association',
-        displayName: association.info.displayName,
-        description: association.info.description,
-        required: association.required,
-        multiple: association.multiple,
-        readOnly: association.readOnly,
-        targetEntities,
-        semantics,
-        cardinality,
-    };
-}
-//# sourceMappingURL=index.js.map

package/build/src/modeling/templates/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modeling/templates/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { DataDomain } from '../DataDomain.js'\nimport type { DomainNamespace } from '../DomainNamespace.js'\nimport type { DomainModel } from '../DomainModel.js'\nimport type { DomainEntity } from '../DomainEntity.js'\nimport type { DomainProperty } from '../DomainProperty.js'\nimport type { DomainAssociation } from '../DomainAssociation.js'\nimport type {\n  AssociationInfo,\n  DomainTemplate,\n  DomainTemplateStructure,\n  EntityInfo,\n  ModelInfo,\n  NamespaceInfo,\n  PropertyInfo,\n} from './types.js'\n\n// Import vertical organization\nexport * from './verticals/index.js'\n\n/**\n * Creates template metadata from a DataDomain instance for UI presentation\n */\nexport function createTemplateMetadata(\n  domain: DataDomain,\n  templateInfo: {\n    id: string\n    name: string\n    description: string\n    version: string\n    author: string\n    tags?: string[]\n    createdAt: string\n    updatedAt: string\n  }\n): DomainTemplate {\n  const structure = analyzeDomainStructure(domain)\n\n  return {\n    id: templateInfo.id,\n    name: templateInfo.name,\n    description: templateInfo.description,\n    createdAt: templateInfo.createdAt,\n    updatedAt: templateInfo.updatedAt,\n    version: templateInfo.version,\n    author: templateInfo.author,\n    tags: templateInfo.tags || [],\n    structure,\n  }\n}\n\n/**\n * Analyzes a DataDomain to extract structural information for UI presentation\n */\nexport function analyzeDomainStructure(domain: DataDomain): DomainTemplateStructure {\n  const namespaces: NamespaceInfo[] = []\n  let totalEntities = 0\n  let totalProperties = 0\n  let totalAssociations = 0\n\n  // Analyze each namespace\n  for (const namespace of domain.listNamespaces()) {\n    const namespaceInfo = analyzeNamespace(namespace)\n    namespaces.push(namespaceInfo)\n\n    totalEntities += namespaceInfo.entityCount\n    totalProperties += namespaceInfo.models.reduce(\n      (sum, model) => sum + model.entities.reduce((entitySum, entity) => entitySum + entity.propertyCount, 0),\n      0\n    )\n    totalAssociations += namespaceInfo.models.reduce(\n      (sum, model) => sum + model.entities.reduce((entitySum, entity) => entitySum + entity.associationCount, 0),\n      0\n    )\n  }\n\n  return {\n    domain: {\n      name: domain.info.name || 'Unnamed Domain',\n      description: domain.info.description,\n      totalEntities,\n      totalProperties,\n      totalAssociations,\n    },\n    namespaces,\n  }\n}\n\n/**\n * Analyzes a DomainNamespace to extract information for UI presentation\n */\nfunction analyzeNamespace(namespace: DomainNamespace): NamespaceInfo {\n  const models: ModelInfo[] = []\n  let entityCount = 0\n\n  // Analyze each model in the namespace\n  for (const model of namespace.listModels()) {\n    const modelInfo = analyzeModel(model)\n    models.push(modelInfo)\n    entityCount += modelInfo.entityCount\n  }\n\n  return {\n    name: namespace.info.name || 'Unnamed Namespace',\n    displayName: namespace.info.displayName,\n    description: namespace.info.description,\n    modelCount: models.length,\n    entityCount,\n    models,\n  }\n}\n\n/**\n * Analyzes a DomainModel to extract information for UI presentation\n */\nfunction analyzeModel(model: DomainModel): ModelInfo {\n  const entities: EntityInfo[] = []\n\n  // Analyze each entity in the model\n  for (const entity of model.listEntities()) {\n    const entityInfo = analyzeEntity(entity)\n    entities.push(entityInfo)\n  }\n\n  return {\n    name: model.info.name || 'Unnamed Model',\n    displayName: model.info.displayName,\n    description: model.info.description,\n    entityCount: entities.length,\n    entities,\n  }\n}\n\n/**\n * Analyzes a DomainEntity to extract information for UI presentation\n */\nfunction analyzeEntity(entity: DomainEntity): EntityInfo {\n  const properties: PropertyInfo[] = []\n  const associations: AssociationInfo[] = []\n\n  // Analyze properties\n  for (const property of entity.listProperties()) {\n    properties.push(analyzeProperty(property))\n  }\n\n  // Analyze associations\n  for (const association of entity.listAssociations()) {\n    associations.push(analyzeAssociation(association))\n  }\n\n  return {\n    name: entity.info.name || 'Unnamed Entity',\n    displayName: entity.info.displayName,\n    description: entity.info.description,\n    propertyCount: properties.length,\n    associationCount: associations.length,\n    deprecated: entity.deprecated,\n    properties,\n    associations,\n    semantics: entity.semantics?.map((s) => s.id) || [],\n  }\n}\n\n/**\n * Analyzes a DomainProperty to extract information for UI presentation\n */\nfunction analyzeProperty(property: DomainProperty): PropertyInfo {\n  const semantics = property.semantics?.map((s) => s.id) || []\n\n  // Extract enum values if present\n  let enumValues: string[] | undefined\n  if (property.schema?.enum && Array.isArray(property.schema.enum)) {\n    enumValues = property.schema.enum.map((v) => String(v))\n  }\n\n  // Extract default value\n  let defaultValue: string | undefined\n  if (property.schema?.defaultValue) {\n    if (property.schema.defaultValue.type === 'literal') {\n      defaultValue = String(property.schema.defaultValue.value)\n    }\n  }\n\n  return {\n    name: property.info.name || 'Unnamed Property',\n    displayName: property.info.displayName,\n    description: property.info.description,\n    type: property.type || 'string',\n    required: property.required,\n    multiple: property.multiple,\n    primary: property.primary,\n    unique: property.unique,\n    readOnly: property.readOnly,\n    writeOnly: property.writeOnly,\n    deprecated: property.deprecated,\n    semantics,\n    enumValues,\n    defaultValue,\n  }\n}\n\n/**\n * Analyzes a DomainAssociation to extract information for UI presentation\n */\nfunction analyzeAssociation(association: DomainAssociation): AssociationInfo {\n  const semantics = association.semantics?.map((s) => s.id) || []\n\n  // Get target entity names\n  const targetEntities =\n    association.targets?.map((target) => {\n      // Try to resolve the target entity to get its name\n      const targetEntity = association.domain.findEntity(target.key)\n      return targetEntity?.info.name || target.key\n    }) || []\n\n  // Determine cardinality description\n  let cardinality = 'One-to-One'\n  if (association.multiple) {\n    cardinality = 'One-to-Many'\n  }\n  // Note: Many-to-Many would typically be determined by looking at the reverse association\n  // but for simplicity in UI presentation, we'll use the current association's multiplicity\n\n  return {\n    name: association.info.name || 'Unnamed Association',\n    displayName: association.info.displayName,\n    description: association.info.description,\n    required: association.required,\n    multiple: association.multiple,\n    readOnly: association.readOnly,\n    targetEntities,\n    semantics,\n    cardinality,\n  }\n}\n"]}

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

@@ -1 +0,0 @@
-{ "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": [] }] }] }] } }

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

@@ -1 +0,0 @@
-{ "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": [] }] }] }] } }