@api-client/core 0.18.3 → 0.18.4

package/build/src/modeling/helpers/database.d.ts

@@ -0,0 +1,24 @@
+export declare function sanitizeInput(input: string): string;
+/**
+ * Converts a string into a sanitized, database column friendly name.
+ * - Sanitizes the input using DOMPurify.
+ * - Converts to lowercase.
+ * - Replaces spaces and multiple underscores with a single underscore.
+ * - Removes any characters that are not alphanumeric or underscore.
+ *
+ * @param inputName The string to format.
+ * @returns A database column friendly name.
+ */
+export declare function toDatabaseColumnName(inputName: string, defaultName?: string): string;
+/**
+ * Converts a string into a sanitized, database table friendly name.
+ * - Sanitizes the input using DOMPurify.
+ * - Converts to lowercase.
+ * - Replaces spaces and multiple underscores with a single underscore.
+ * - Removes any characters that are not alphanumeric or underscore.
+ *
+ * @param inputName The string to format.
+ * @returns A database table friendly name.
+ */
+export declare function toDatabaseTableName(inputName: string, defaultName?: string): string;
+//# sourceMappingURL=database.d.ts.map

package/build/src/modeling/helpers/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../../../src/modeling/helpers/database.ts"],"names":[],"mappings":"AAGA,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,SAAoB,GAAG,MAAM,CAiB/F;AACD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,SAAmB,GAAG,MAAM,CAE7F"}

package/build/src/modeling/helpers/database.js

@@ -0,0 +1,42 @@
+import DOMPurify from 'isomorphic-dompurify';
+import { snakeCase } from '@pawel-up/jexl/string.js';
+export function sanitizeInput(input) {
+    return DOMPurify.isSupported ? DOMPurify.sanitize(input) : input;
+}
+/**
+ * Converts a string into a sanitized, database column friendly name.
+ * - Sanitizes the input using DOMPurify.
+ * - Converts to lowercase.
+ * - Replaces spaces and multiple underscores with a single underscore.
+ * - Removes any characters that are not alphanumeric or underscore.
+ *
+ * @param inputName The string to format.
+ * @returns A database column friendly name.
+ */
+export function toDatabaseColumnName(inputName, defaultName = 'untitled_column') {
+    // 1. Sanitize
+    let name = sanitizeInput(inputName);
+    // 2. Convert to lowercase
+    name = snakeCase(name);
+    // 3. Replace spaces and multiple hyphens/underscores with a single underscore
+    name = name.replace(/[\s-]+/g, '_');
+    // 4. Remove any characters that are not alphanumeric or underscore
+    name = name.replace(/[^a-z0-9_]/g, '');
+    // 5. Ensure it doesn't start or end with an underscore (optional, but good practice)
+    name = name.replace(/^_+|_+$/g, '');
+    return name || defaultName;
+}
+/**
+ * Converts a string into a sanitized, database table friendly name.
+ * - Sanitizes the input using DOMPurify.
+ * - Converts to lowercase.
+ * - Replaces spaces and multiple underscores with a single underscore.
+ * - Removes any characters that are not alphanumeric or underscore.
+ *
+ * @param inputName The string to format.
+ * @returns A database table friendly name.
+ */
+export function toDatabaseTableName(inputName, defaultName = 'untitled_table') {
+    return toDatabaseColumnName(inputName, defaultName);
+}
+//# sourceMappingURL=database.js.map

package/build/src/modeling/helpers/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../../../src/modeling/helpers/database.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,sBAAsB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAEpD,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;AAClE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB,EAAE,WAAW,GAAG,iBAAiB;IACrF,cAAc;IACd,IAAI,IAAI,GAAG,aAAa,CAAC,SAAS,CAAC,CAAA;IAEnC,0BAA0B;IAC1B,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAEtB,8EAA8E;IAC9E,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;IAEnC,mEAAmE;IACnE,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAA;IAEtC,qFAAqF;IACrF,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;IAEnC,OAAO,IAAI,IAAI,WAAW,CAAA;AAC5B,CAAC;AACD;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB,EAAE,WAAW,GAAG,gBAAgB;IACnF,OAAO,oBAAoB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAA;AACrD,CAAC","sourcesContent":["import DOMPurify from 'isomorphic-dompurify'\nimport { snakeCase } from '@pawel-up/jexl/string.js'\n\nexport function sanitizeInput(input: string): string {\n  return DOMPurify.isSupported ? DOMPurify.sanitize(input) : input\n}\n\n/**\n * Converts a string into a sanitized, database column friendly name.\n * - Sanitizes the input using DOMPurify.\n * - Converts to lowercase.\n * - Replaces spaces and multiple underscores with a single underscore.\n * - Removes any characters that are not alphanumeric or underscore.\n *\n * @param inputName The string to format.\n * @returns A database column friendly name.\n */\nexport function toDatabaseColumnName(inputName: string, defaultName = 'untitled_column'): string {\n  // 1. Sanitize\n  let name = sanitizeInput(inputName)\n\n  // 2. Convert to lowercase\n  name = snakeCase(name)\n\n  // 3. Replace spaces and multiple hyphens/underscores with a single underscore\n  name = name.replace(/[\\s-]+/g, '_')\n\n  // 4. Remove any characters that are not alphanumeric or underscore\n  name = name.replace(/[^a-z0-9_]/g, '')\n\n  // 5. Ensure it doesn't start or end with an underscore (optional, but good practice)\n  name = name.replace(/^_+|_+$/g, '')\n\n  return name || defaultName\n}\n/**\n * Converts a string into a sanitized, database table friendly name.\n * - Sanitizes the input using DOMPurify.\n * - Converts to lowercase.\n * - Replaces spaces and multiple underscores with a single underscore.\n * - Removes any characters that are not alphanumeric or underscore.\n *\n * @param inputName The string to format.\n * @returns A database table friendly name.\n */\nexport function toDatabaseTableName(inputName: string, defaultName = 'untitled_table'): string {\n  return toDatabaseColumnName(inputName, defaultName)\n}\n"]}

package/build/src/modeling/importers/CsvImporter.d.ts

@@ -0,0 +1,36 @@
+import { type CSVOptions, type ParseResult } from '@pawel-up/csv';
+import type { DataDomain } from '../DataDomain.js';
+export type { CSVOptions, ParseResult };
+/**
+ * Imports CSV data into a DataDomain.
+ *
+ * This class parses CSV files and translates the column definitions into DomainProperty instances
+ * within a specified DomainModel and DomainEntity.
+ */
+export declare class CsvImporter {
+    private parser;
+    private domain;
+    /**
+     * Creates an instance of CsvImporter.
+     * @param domain The DataDomain to which the imported data will be added.
+     * @param options Optional CSV parsing options.
+     */
+    constructor(domain: DataDomain, options?: CSVOptions);
+    /**
+     * Parses a CSV file or string to extract its structure and data.
+     * This is a wrapper around the underlying CSV parser.
+     * @param csv The CSV content to parse, as a File object or a string.
+     * @returns A promise that resolves with the parsed result.
+     */
+    parse(csv: File | string): Promise<ParseResult>;
+    /**
+     * Imports the parsed CSV data structure into the domain as a new model and entity.
+     * It creates a `DomainEntity` where each column from the CSV is represented as a `DomainProperty`.
+     * The first row of data is used to provide an example value for each property.
+     * @param data The result from the `parse` method, containing the CSV structure and values.
+     * @param modelName The name to be used for the created `DomainModel` and `DomainEntity`.
+     * @returns A promise that resolves when the import is complete.
+     */
+    import(data: ParseResult, modelName: string): Promise<void>;
+}
+//# sourceMappingURL=CsvImporter.d.ts.map

package/build/src/modeling/importers/CsvImporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CsvImporter.d.ts","sourceRoot":"","sources":["../../../../src/modeling/importers/CsvImporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAa,KAAK,WAAW,EAAE,MAAM,eAAe,CAAA;AAC5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAIlD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,CAAA;AAEvC;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,MAAM,CAAY;IAE1B;;;;OAIG;gBACS,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,UAAU;IAKpD;;;;;OAKG;IACI,KAAK,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAItD;;;;;;;OAOG;IACU,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA0CzE"}

package/build/src/modeling/importers/CsvImporter.js

@@ -0,0 +1,81 @@
+import { CSVParser } from '@pawel-up/csv';
+import { sanitizeInput, toDatabaseColumnName, toDatabaseTableName } from '../helpers/database.js';
+/**
+ * Imports CSV data into a DataDomain.
+ *
+ * This class parses CSV files and translates the column definitions into DomainProperty instances
+ * within a specified DomainModel and DomainEntity.
+ */
+export class CsvImporter {
+    parser;
+    domain;
+    /**
+     * Creates an instance of CsvImporter.
+     * @param domain The DataDomain to which the imported data will be added.
+     * @param options Optional CSV parsing options.
+     */
+    constructor(domain, options) {
+        this.parser = new CSVParser(options);
+        this.domain = domain;
+    }
+    /**
+     * Parses a CSV file or string to extract its structure and data.
+     * This is a wrapper around the underlying CSV parser.
+     * @param csv The CSV content to parse, as a File object or a string.
+     * @returns A promise that resolves with the parsed result.
+     */
+    parse(csv) {
+        return this.parser.parse(csv);
+    }
+    /**
+     * Imports the parsed CSV data structure into the domain as a new model and entity.
+     * It creates a `DomainEntity` where each column from the CSV is represented as a `DomainProperty`.
+     * The first row of data is used to provide an example value for each property.
+     * @param data The result from the `parse` method, containing the CSV structure and values.
+     * @param modelName The name to be used for the created `DomainModel` and `DomainEntity`.
+     * @returns A promise that resolves when the import is complete.
+     */
+    async import(data, modelName) {
+        const name = toDatabaseTableName(modelName, 'imported_cvs_data');
+        const model = this.domain.addModel({ info: { name } });
+        const entity = model.addEntity({ info: { name } });
+        const sanitizedInputName = sanitizeInput(modelName);
+        if (name !== sanitizedInputName) {
+            model.info.displayName = sanitizedInputName;
+            entity.info.displayName = sanitizedInputName;
+        }
+        for (const row of data.format) {
+            const { index, name, type, format } = row;
+            const columnName = toDatabaseColumnName(name, `column_${index}`);
+            const schema = {
+                info: { name: columnName },
+                type,
+            };
+            if (format) {
+                schema.bindings = [
+                    {
+                        type: 'web',
+                        schema: {
+                            format: format === 'integer' ? 'int64' : 'double',
+                        },
+                    },
+                ];
+            }
+            const exampleRow = data.values[0];
+            if (Array.isArray(exampleRow) && exampleRow[index]) {
+                const value = exampleRow[index];
+                if (value !== undefined && value !== null) {
+                    schema.schema = {
+                        examples: [sanitizeInput(String(value))],
+                    };
+                }
+            }
+            const prop = entity.addProperty(schema);
+            const sn = sanitizeInput(name);
+            if (sn !== columnName) {
+                prop.info.displayName = sn;
+            }
+        }
+    }
+}
+//# sourceMappingURL=CsvImporter.js.map

package/build/src/modeling/importers/CsvImporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CsvImporter.js","sourceRoot":"","sources":["../../../../src/modeling/importers/CsvImporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,SAAS,EAAoB,MAAM,eAAe,CAAA;AAE5E,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAKjG;;;;;GAKG;AACH,MAAM,OAAO,WAAW;IACd,MAAM,CAAW;IACjB,MAAM,CAAY;IAE1B;;;;OAIG;IACH,YAAY,MAAkB,EAAE,OAAoB;QAClD,IAAI,CAAC,MAAM,GAAG,IAAI,SAAS,CAAC,OAAO,CAAC,CAAA;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,GAAkB;QAC7B,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC/B,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,MAAM,CAAC,IAAiB,EAAE,SAAiB;QACtD,MAAM,IAAI,GAAG,mBAAmB,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAA;QAChE,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAA;QACtD,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAA;QAClD,MAAM,kBAAkB,GAAG,aAAa,CAAC,SAAS,CAAC,CAAA;QACnD,IAAI,IAAI,KAAK,kBAAkB,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,kBAAkB,CAAA;YAC3C,MAAM,CAAC,IAAI,CAAC,WAAW,GAAG,kBAAkB,CAAA;QAC9C,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC9B,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,CAAA;YACzC,MAAM,UAAU,GAAG,oBAAoB,CAAC,IAAI,EAAE,UAAU,KAAK,EAAE,CAAC,CAAA;YAChE,MAAM,MAAM,GAAkC;gBAC5C,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;gBAC1B,IAAI;aACL,CAAA;YACD,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,CAAC,QAAQ,GAAG;oBAChB;wBACE,IAAI,EAAE,KAAK;wBACX,MAAM,EAAE;4BACN,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ;yBAClD;qBACF;iBACF,CAAA;YACH,CAAC;YACD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;YACjC,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBACnD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;gBAC/B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBAC1C,MAAM,CAAC,MAAM,GAAG;wBACd,QAAQ,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;qBACzC,CAAA;gBACH,CAAC;YACH,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;YACvC,MAAM,EAAE,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;YAC9B,IAAI,EAAE,KAAK,UAAU,EAAE,CAAC;gBACtB,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,EAAE,CAAA;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;CACF","sourcesContent":["import { type CSVOptions, CSVParser, type ParseResult } from '@pawel-up/csv'\nimport type { DataDomain } from '../DataDomain.js'\nimport { sanitizeInput, toDatabaseColumnName, toDatabaseTableName } from '../helpers/database.js'\nimport type { DomainPropertySchema } from '../DomainProperty.js'\n\nexport type { CSVOptions, ParseResult }\n\n/**\n * Imports CSV data into a DataDomain.\n *\n * This class parses CSV files and translates the column definitions into DomainProperty instances\n * within a specified DomainModel and DomainEntity.\n */\nexport class CsvImporter {\n  private parser: CSVParser\n  private domain: DataDomain\n\n  /**\n   * Creates an instance of CsvImporter.\n   * @param domain The DataDomain to which the imported data will be added.\n   * @param options Optional CSV parsing options.\n   */\n  constructor(domain: DataDomain, options?: CSVOptions) {\n    this.parser = new CSVParser(options)\n    this.domain = domain\n  }\n\n  /**\n   * Parses a CSV file or string to extract its structure and data.\n   * This is a wrapper around the underlying CSV parser.\n   * @param csv The CSV content to parse, as a File object or a string.\n   * @returns A promise that resolves with the parsed result.\n   */\n  public parse(csv: File | string): Promise<ParseResult> {\n    return this.parser.parse(csv)\n  }\n\n  /**\n   * Imports the parsed CSV data structure into the domain as a new model and entity.\n   * It creates a `DomainEntity` where each column from the CSV is represented as a `DomainProperty`.\n   * The first row of data is used to provide an example value for each property.\n   * @param data The result from the `parse` method, containing the CSV structure and values.\n   * @param modelName The name to be used for the created `DomainModel` and `DomainEntity`.\n   * @returns A promise that resolves when the import is complete.\n   */\n  public async import(data: ParseResult, modelName: string): Promise<void> {\n    const name = toDatabaseTableName(modelName, 'imported_cvs_data')\n    const model = this.domain.addModel({ info: { name } })\n    const entity = model.addEntity({ info: { name } })\n    const sanitizedInputName = sanitizeInput(modelName)\n    if (name !== sanitizedInputName) {\n      model.info.displayName = sanitizedInputName\n      entity.info.displayName = sanitizedInputName\n    }\n    for (const row of data.format) {\n      const { index, name, type, format } = row\n      const columnName = toDatabaseColumnName(name, `column_${index}`)\n      const schema: Partial<DomainPropertySchema> = {\n        info: { name: columnName },\n        type,\n      }\n      if (format) {\n        schema.bindings = [\n          {\n            type: 'web',\n            schema: {\n              format: format === 'integer' ? 'int64' : 'double',\n            },\n          },\n        ]\n      }\n      const exampleRow = data.values[0]\n      if (Array.isArray(exampleRow) && exampleRow[index]) {\n        const value = exampleRow[index]\n        if (value !== undefined && value !== null) {\n          schema.schema = {\n            examples: [sanitizeInput(String(value))],\n          }\n        }\n      }\n      const prop = entity.addProperty(schema)\n      const sn = sanitizeInput(name)\n      if (sn !== columnName) {\n        prop.info.displayName = sn\n      }\n    }\n  }\n}\n"]}

package/build/src/modeling/importers/ImporterException.d.ts

@@ -0,0 +1,10 @@
+import { Exception } from '../../exceptions/exception.js';
+/**
+ * An exception thrown during the JSON Schema import process when an
+ * unrecoverable error occurs.
+ */
+export declare class ImporterException extends Exception {
+    static code: string;
+    static status: number;
+}
+//# sourceMappingURL=ImporterException.d.ts.map

package/build/src/modeling/importers/ImporterException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImporterException.d.ts","sourceRoot":"","sources":["../../../../src/modeling/importers/ImporterException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAA;AAEzD;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,OAAgB,IAAI,SAAuB;IAC3C,OAAgB,MAAM,SAAM;CAC7B"}

package/build/src/modeling/importers/ImporterException.js

@@ -0,0 +1,10 @@
+import { Exception } from '../../exceptions/exception.js';
+/**
+ * An exception thrown during the JSON Schema import process when an
+ * unrecoverable error occurs.
+ */
+export class ImporterException extends Exception {
+    static code = 'E_IMPORTER_FAILURE';
+    static status = 400; // Bad Request, as it's likely due to invalid input schemas
+}
+//# sourceMappingURL=ImporterException.js.map

package/build/src/modeling/importers/ImporterException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImporterException.js","sourceRoot":"","sources":["../../../../src/modeling/importers/ImporterException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAA;AAEzD;;;GAGG;AACH,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IAC9C,MAAM,CAAU,IAAI,GAAG,oBAAoB,CAAA;IAC3C,MAAM,CAAU,MAAM,GAAG,GAAG,CAAA,CAAC,2DAA2D","sourcesContent":["import { Exception } from '../../exceptions/exception.js'\n\n/**\n * An exception thrown during the JSON Schema import process when an\n * unrecoverable error occurs.\n */\nexport class ImporterException extends Exception {\n  static override code = 'E_IMPORTER_FAILURE'\n  static override status = 400 // Bad Request, as it's likely due to invalid input schemas\n}\n"]}

package/build/src/modeling/importers/JsonSchemaImporter.d.ts

@@ -0,0 +1,99 @@
+import type { JSONSchema7 } from 'json-schema';
+import { DataDomain } from '../DataDomain.js';
+import { DomainModel } from '../DomainModel.js';
+/**
+ * Represents a single message (info, warning, or error) generated during the import process.
+ */
+export interface ImportMessage {
+    level: 'warning' | 'info';
+    message: string;
+    location?: string;
+}
+/**
+ * A report containing the result of the import process, including the created model
+ * and any non-blocking messages.
+ */
+export interface JsonImportReport {
+    /**
+     * An array of messages generated during the import process.
+     * These can include warnings, info messages, or other non-blocking notifications.
+     */
+    messages: ImportMessage[];
+    /**
+     * The model that was created during the import.
+     */
+    model: DomainModel;
+}
+/**
+ * A structure to hold in-memory JSON schema files for browser-based import.
+ */
+export interface InMemorySchema {
+    /** A virtual path or identifier for the schema, used in `$ref` values. */
+    path: string;
+    /** The parsed content of the JSON schema file. */
+    contents: JSONSchema7;
+}
+/**
+ * Imports JSON Schema definitions into a DataDomain.
+ *
+ * This class parses a root JSON Schema file, bundles all its dependencies,
+ * and translates the object definitions into DomainEntity instances within a specified DomainModel.
+ */
+export declare class JsonSchemaImporter {
+    private domain;
+    private model;
+    private refMap;
+    private messages;
+    private enums;
+    constructor(domain: DataDomain);
+    /**
+     * Resets the internal state for a new import operation.
+     */
+    private resetState;
+    /**
+     * Centralized reporting for warnings and info messages.
+     */
+    private report;
+    /**
+     * Main import method: orchestrates schema bundling, entity creation, and population.
+     */
+    import(schemas: InMemorySchema[], modelName: string): Promise<JsonImportReport>;
+    private isEnum;
+    /**
+     * Resolves a schema reference from the flat definition/id maps.
+     * Supports #/definitions/..., $id, or direct path keys.
+     */
+    private resolveSchemaRef;
+    /**
+     * Helper for entity creation, can be extended for custom logic.
+     */
+    private createEntity;
+    /**
+     * Populates a DomainEntity with its properties, associations, and parent relationships.
+     */
+    private populateEntity;
+    /**
+     * Processes the `allOf` keyword, which can contain references (for inheritance)
+     * or inline schemas (for composition/mixins).
+     */
+    private processAllOf;
+    /**
+     * Recursively analyzes a schema definition to find all contained primitive types and `$ref`s.
+     * It's used to understand the nature of a property (is it a primitive, an association, or a mix).
+     */
+    private collectTypesAndRefs;
+    /**
+     * Determines whether to create a DomainProperty or a DomainAssociation for a given schema property.
+     */
+    private createPropertyOrAssociation;
+    /**
+     * Creates and configures a DomainProperty based on a JSON schema property definition.
+     */
+    private createDomainProperty;
+    /**
+     * Maps a JSON Schema type to a DomainPropertyType.
+     */
+    private mapJsonTypeToDomainType;
+    private createEnumProperty;
+}
+//# sourceMappingURL=JsonSchemaImporter.d.ts.map

package/build/src/modeling/importers/JsonSchemaImporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonSchemaImporter.d.ts","sourceRoot":"","sources":["../../../../src/modeling/importers/JsonSchemaImporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAA8C,MAAM,aAAa,CAAA;AAC1F,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAQ/C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,SAAS,GAAG,MAAM,CAAA;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,QAAQ,EAAE,aAAa,EAAE,CAAA;IACzB;;OAEG;IACH,KAAK,EAAE,WAAW,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAA;IACZ,kDAAkD;IAClD,QAAQ,EAAE,WAAW,CAAA;CACtB;AAED;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,KAAK,CAAiC;gBAElC,MAAM,EAAE,UAAU;IAI9B;;OAEG;IACH,OAAO,CAAC,UAAU;IAOlB;;OAEG;IACH,OAAO,CAAC,MAAM;IAId;;OAEG;IACU,MAAM,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqE5F,OAAO,CAAC,MAAM;IAYd;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAuBxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAmBpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAgBtB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAgDpB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAiD3B;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAwEnC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA0D5B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAuE/B,OAAO,CAAC,kBAAkB;CA+F3B"}