@api-client/core 0.19.19 → 0.19.20

package/build/src/modeling/generators/oas_320/OasSchemaGenerator.js

@@ -0,0 +1,237 @@
+import { SemanticType } from '../../Semantics.js';
+export class OasSchemaGenerator {
+    domain;
+    memorySchemas = {};
+    memoryNames = {};
+    constructor(domain) {
+        this.domain = domain;
+    }
+    /**
+     * Retrieves the dictionary of all processed OAS JSON schemas.
+     */
+    getSchemas() {
+        const result = {};
+        for (const [key, value] of Object.entries(this.memorySchemas)) {
+            result[this.memoryNames[key]] = value;
+        }
+        return result;
+    }
+    /**
+     * Generates schemas recursively for an entity and returns the $ref pointing to the root representation.
+     * @param entity
+     */
+    generateRootRef(entity) {
+        this.generateEntity(entity);
+        return { $ref: `#/components/schemas/${this.generateSchemaKey(entity)}` };
+    }
+    /**
+     * Generates a schema key for an entity.
+     */
+    generateSchemaKey(entity) {
+        return entity.info.name || 'entity ' + entity.key;
+    }
+    generateEntity(entity) {
+        if (this.memorySchemas[entity.key]) {
+            return; // Already processed or processing
+        }
+        // Preemptively assign to avoid infinite recursion over bidirectional associations
+        const schema = {
+            type: 'object',
+            properties: {},
+            required: [],
+        };
+        this.memorySchemas[entity.key] = schema;
+        const schemaKey = this.generateSchemaKey(entity);
+        this.memoryNames[entity.key] = schemaKey;
+        const required = [];
+        for (const prop of entity.properties) {
+            if (prop.required && !prop.readOnly) {
+                required.push(prop.info.name || prop.key);
+            }
+            if (!schema.properties) {
+                schema.properties = {};
+            }
+            const webBindings = prop.readBinding('web');
+            if (webBindings?.hidden) {
+                continue;
+            }
+            schema.properties[prop.info.name || prop.key] = this.mapPropertyBase(prop, webBindings);
+        }
+        for (const assoc of entity.associations) {
+            const bindings = assoc.readBinding('web');
+            if (bindings?.hidden) {
+                continue;
+            }
+            const targets = Array.from(assoc.listTargets());
+            if (targets.length === 0)
+                continue;
+            const linked = assoc.schema?.linked === true;
+            const targetRefs = [];
+            for (const targetEntity of targets) {
+                if (linked) {
+                    // When an entity is linked then we treat it as a regular property, which value is a key to
+                    // the target entity. The consuming application has to construct the endpoint manually.
+                    const targetName = targetEntity.info.displayName || targetEntity.info.name || targetEntity.key;
+                    targetRefs.push({
+                        type: 'string',
+                        description: `The ID of the linked ${targetName}.`,
+                    });
+                }
+                else {
+                    // If not linked, embed the resource as a reference to the schema.
+                    if (targetEntity !== entity) {
+                        this.generateEntity(targetEntity);
+                    }
+                    targetRefs.push({ $ref: `#/components/schemas/${this.generateSchemaKey(targetEntity)}` });
+                }
+            }
+            let assocSchema;
+            if (targetRefs.length > 1) {
+                const unionType = assoc.schema?.unionType || 'anyOf';
+                if (unionType === 'oneOf') {
+                    assocSchema = { oneOf: targetRefs };
+                }
+                else if (unionType === 'allOf') {
+                    assocSchema = { allOf: targetRefs };
+                }
+                else {
+                    assocSchema = { anyOf: targetRefs };
+                }
+            }
+            else {
+                assocSchema = targetRefs[0];
+            }
+            const propName = assoc.info.name || assoc.key;
+            if (!schema.properties) {
+                schema.properties = {};
+            }
+            if (assoc.multiple) {
+                schema.properties[propName] = {
+                    type: 'array',
+                    items: assocSchema,
+                };
+            }
+            else {
+                schema.properties[propName] = assocSchema;
+            }
+        }
+        if (required.length > 0) {
+            schema.required = required;
+        }
+        else {
+            delete schema.required;
+        }
+    }
+    mapPropertyBase(prop, webBindings) {
+        const base = {};
+        if (prop.readOnly) {
+            base.readOnly = true;
+        }
+        if (prop.writeOnly) {
+            base.writeOnly = true;
+        }
+        if (prop.deprecated) {
+            base.deprecated = true;
+        }
+        if (prop.schema) {
+            if (prop.schema.minimum !== undefined) {
+                if (prop.schema.exclusiveMinimum) {
+                    base.exclusiveMinimum = prop.schema.minimum;
+                }
+                else {
+                    base.minimum = prop.schema.minimum;
+                }
+            }
+            if (prop.schema.maximum !== undefined) {
+                if (prop.schema.exclusiveMaximum) {
+                    base.exclusiveMaximum = prop.schema.maximum;
+                }
+                else {
+                    base.maximum = prop.schema.maximum;
+                }
+            }
+            if (prop.schema.pattern) {
+                base.pattern = prop.schema.pattern;
+            }
+            if (prop.schema.enum) {
+                base.enum = [...prop.schema.enum];
+            }
+            if (prop.schema.defaultValue?.value !== undefined) {
+                base.default = prop.schema.defaultValue.value;
+            }
+            if (prop.schema.examples) {
+                base.examples = [...prop.schema.examples];
+            }
+        }
+        if (prop.info && prop.info.description) {
+            base.description = prop.info.description;
+        }
+        if (prop.hasSemantic(SemanticType.Password)) {
+            base.format = 'password';
+        }
+        if (webBindings?.xml) {
+            base.xml = { ...webBindings.xml };
+        }
+        switch (prop.type) {
+            case 'string':
+                base.type = 'string';
+                break;
+            case 'number':
+                if (webBindings?.format === 'int32' || webBindings?.format === 'int64') {
+                    base.type = 'integer';
+                }
+                else {
+                    base.type = 'number';
+                }
+                if (prop.schema?.multipleOf !== undefined) {
+                    base.multipleOf = prop.schema.multipleOf;
+                }
+                break;
+            case 'boolean':
+                base.type = 'boolean';
+                break;
+            case 'date':
+                base.type = 'string';
+                base.format = 'date';
+                break;
+            case 'datetime':
+                base.type = 'string';
+                base.format = 'date-time';
+                break;
+            case 'time':
+                base.type = 'string';
+                base.format = 'time';
+                break;
+            case 'binary':
+                base.type = 'string';
+                if (webBindings?.format) {
+                    base.format = webBindings.format;
+                }
+                else {
+                    base.format = 'binary';
+                }
+                if (webBindings?.fileTypes && webBindings.fileTypes.length > 0) {
+                    const typesStr = webBindings.fileTypes.join(', ');
+                    // Standard JSON Schema keyword for media wrapping (single value string usually,
+                    // but some tools handle comma separated)
+                    base.contentMediaType = webBindings.fileTypes.length === 1 ? webBindings.fileTypes[0] : typesStr;
+                    // Vendor extension for tools supporting multiple explicit arrays
+                    // ;(base as any)['x-file-types'] = webBindings.fileTypes
+                    // Append to description so viewers can always see the requirements natively
+                    const typesDesc = `**Allowed file types:** ${typesStr}`;
+                    base.description = base.description ? `${base.description}\n\n${typesDesc}` : typesDesc;
+                }
+                break;
+            default:
+                base.type = 'string'; // fallback
+        }
+        if (prop.multiple) {
+            return {
+                type: 'array',
+                items: base,
+            };
+        }
+        return base;
+    }
+}
+//# sourceMappingURL=OasSchemaGenerator.js.map

package/build/src/modeling/generators/oas_320/OasSchemaGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OasSchemaGenerator.js","sourceRoot":"","sources":["../../../../../src/modeling/generators/oas_320/OasSchemaGenerator.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReferenceObject, SchemaObject } from './types.js'\nimport { AssociationWebBindings, PropertyWebBindings } from '../../Bindings.js'\nimport type { DataDomain } from '../../DataDomain.js'\nimport type { DomainEntity } from '../../DomainEntity.js'\nimport type { DomainProperty } from '../../DomainProperty.js'\nimport { SemanticType } from '../../Semantics.js'\n\nexport class OasSchemaGenerator {\n  private memorySchemas: Record<string, SchemaObject> = {}\n  private memoryNames: Record<string, string> = {}\n\n  constructor(private domain: DataDomain) {}\n\n  /**\n   * Retrieves the dictionary of all processed OAS JSON schemas.\n   */\n  public getSchemas(): Record<string, SchemaObject> {\n    const result: Record<string, SchemaObject> = {}\n    for (const [key, value] of Object.entries(this.memorySchemas)) {\n      result[this.memoryNames[key]] = value\n    }\n    return result\n  }\n\n  /**\n   * Generates schemas recursively for an entity and returns the $ref pointing to the root representation.\n   * @param entity\n   */\n  public generateRootRef(entity: DomainEntity): ReferenceObject {\n    this.generateEntity(entity)\n    return { $ref: `#/components/schemas/${this.generateSchemaKey(entity)}` }\n  }\n\n  /**\n   * Generates a schema key for an entity.\n   */\n  public generateSchemaKey(entity: DomainEntity): string {\n    return entity.info.name || 'entity ' + entity.key\n  }\n\n  private generateEntity(entity: DomainEntity): void {\n    if (this.memorySchemas[entity.key]) {\n      return // Already processed or processing\n    }\n\n    // Preemptively assign to avoid infinite recursion over bidirectional associations\n    const schema: SchemaObject = {\n      type: 'object',\n      properties: {},\n      required: [],\n    }\n    this.memorySchemas[entity.key] = schema\n    const schemaKey = this.generateSchemaKey(entity)\n    this.memoryNames[entity.key] = schemaKey\n\n    const required: string[] = []\n\n    for (const prop of entity.properties) {\n      if (prop.required && !prop.readOnly) {\n        required.push(prop.info.name || prop.key)\n      }\n      if (!schema.properties) {\n        schema.properties = {}\n      }\n      const webBindings = prop.readBinding('web') as PropertyWebBindings | undefined\n      if (webBindings?.hidden) {\n        continue\n      }\n      schema.properties[prop.info.name || prop.key] = this.mapPropertyBase(prop, webBindings)\n    }\n\n    for (const assoc of entity.associations) {\n      const bindings = assoc.readBinding('web') as AssociationWebBindings | undefined\n      if (bindings?.hidden) {\n        continue\n      }\n\n      const targets = Array.from(assoc.listTargets())\n      if (targets.length === 0) continue\n\n      const linked = assoc.schema?.linked === true\n      const targetRefs: (SchemaObject | ReferenceObject)[] = []\n\n      for (const targetEntity of targets) {\n        if (linked) {\n          // When an entity is linked then we treat it as a regular property, which value is a key to\n          // the target entity. The consuming application has to construct the endpoint manually.\n          const targetName = targetEntity.info.displayName || targetEntity.info.name || targetEntity.key\n          targetRefs.push({\n            type: 'string',\n            description: `The ID of the linked ${targetName}.`,\n          })\n        } else {\n          // If not linked, embed the resource as a reference to the schema.\n          if (targetEntity !== entity) {\n            this.generateEntity(targetEntity)\n          }\n          targetRefs.push({ $ref: `#/components/schemas/${this.generateSchemaKey(targetEntity)}` })\n        }\n      }\n\n      let assocSchema: SchemaObject | ReferenceObject\n      if (targetRefs.length > 1) {\n        const unionType = assoc.schema?.unionType || 'anyOf'\n        if (unionType === 'oneOf') {\n          assocSchema = { oneOf: targetRefs }\n        } else if (unionType === 'allOf') {\n          assocSchema = { allOf: targetRefs }\n        } else {\n          assocSchema = { anyOf: targetRefs }\n        }\n      } else {\n        assocSchema = targetRefs[0]\n      }\n\n      const propName = assoc.info.name || assoc.key\n      if (!schema.properties) {\n        schema.properties = {}\n      }\n\n      if (assoc.multiple) {\n        schema.properties[propName] = {\n          type: 'array',\n          items: assocSchema,\n        }\n      } else {\n        schema.properties[propName] = assocSchema\n      }\n    }\n\n    if (required.length > 0) {\n      schema.required = required\n    } else {\n      delete schema.required\n    }\n  }\n\n  private mapPropertyBase(prop: DomainProperty, webBindings?: PropertyWebBindings): SchemaObject | ReferenceObject {\n    const base: SchemaObject = {}\n\n    if (prop.readOnly) {\n      base.readOnly = true\n    }\n\n    if (prop.writeOnly) {\n      base.writeOnly = true\n    }\n\n    if (prop.deprecated) {\n      base.deprecated = true\n    }\n\n    if (prop.schema) {\n      if (prop.schema.minimum !== undefined) {\n        if (prop.schema.exclusiveMinimum) {\n          base.exclusiveMinimum = prop.schema.minimum\n        } else {\n          base.minimum = prop.schema.minimum\n        }\n      }\n      if (prop.schema.maximum !== undefined) {\n        if (prop.schema.exclusiveMaximum) {\n          base.exclusiveMaximum = prop.schema.maximum\n        } else {\n          base.maximum = prop.schema.maximum\n        }\n      }\n      if (prop.schema.pattern) {\n        base.pattern = prop.schema.pattern\n      }\n      if (prop.schema.enum) {\n        base.enum = [...prop.schema.enum]\n      }\n      if (prop.schema.defaultValue?.value !== undefined) {\n        base.default = prop.schema.defaultValue.value\n      }\n      if (prop.schema.examples) {\n        base.examples = [...prop.schema.examples]\n      }\n    }\n\n    if (prop.info && prop.info.description) {\n      base.description = prop.info.description\n    }\n\n    if (prop.hasSemantic(SemanticType.Password)) {\n      base.format = 'password'\n    }\n\n    if (webBindings?.xml) {\n      base.xml = { ...webBindings.xml }\n    }\n\n    switch (prop.type) {\n      case 'string':\n        base.type = 'string'\n        break\n      case 'number':\n        if (webBindings?.format === 'int32' || webBindings?.format === 'int64') {\n          base.type = 'integer'\n        } else {\n          base.type = 'number'\n        }\n        if (prop.schema?.multipleOf !== undefined) {\n          base.multipleOf = prop.schema.multipleOf\n        }\n        break\n      case 'boolean':\n        base.type = 'boolean'\n        break\n      case 'date':\n        base.type = 'string'\n        base.format = 'date'\n        break\n      case 'datetime':\n        base.type = 'string'\n        base.format = 'date-time'\n        break\n      case 'time':\n        base.type = 'string'\n        base.format = 'time'\n        break\n      case 'binary':\n        base.type = 'string'\n        if (webBindings?.format) {\n          base.format = webBindings.format\n        } else {\n          base.format = 'binary'\n        }\n        if (webBindings?.fileTypes && webBindings.fileTypes.length > 0) {\n          const typesStr = webBindings.fileTypes.join(', ')\n          // Standard JSON Schema keyword for media wrapping (single value string usually,\n          // but some tools handle comma separated)\n          base.contentMediaType = webBindings.fileTypes.length === 1 ? webBindings.fileTypes[0] : typesStr\n          // Vendor extension for tools supporting multiple explicit arrays\n          // ;(base as any)['x-file-types'] = webBindings.fileTypes\n          // Append to description so viewers can always see the requirements natively\n          const typesDesc = `**Allowed file types:** ${typesStr}`\n          base.description = base.description ? `${base.description}\\n\\n${typesDesc}` : typesDesc\n        }\n        break\n      default:\n        base.type = 'string' // fallback\n    }\n\n    if (prop.multiple) {\n      return {\n        type: 'array',\n        items: base,\n      }\n    }\n\n    return base\n  }\n}\n"]}