@ama-openapi/core 0.0.0-placeholder

package/package.json

@@ -0,0 +1,105 @@
+{
+  "name": "@ama-openapi/core",
+  "version": "0.0.0-placeholder",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "typings": "./src/public_api.d.mts",
+  "main": "./src/public_api.mjs",
+  "description": "Package exposing core function to manage OpenAPI dependencies",
+  "keywords": [
+    "otter",
+    "otter-module",
+    "openapi"
+  ],
+  "scripts": {
+    "nx": "nx",
+    "ng": "yarn nx",
+    "copy:schemas": "yarn cpy 'schemas/*.json' dist/schemas",
+    "copy:renovate": "yarn cpy 'renovate/*.json' dist/renovate",
+    "build:source": "tsc -b tsconfig.build.json && yarn cpy package.json dist/",
+    "build": "yarn nx build ama-openapi-core",
+    "postbuild": "patch-package-json-main"
+  },
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    "./schemas/*.json": {
+      "default": "./schemas/*.json"
+    },
+    "./renovate/*.json": {
+      "default": "./renovate/*.json"
+    },
+    ".": {
+      "module": "./src/public_api.mjs",
+      "typings": "./src/public_api.d.mts",
+      "default": "./src/public_api.mjs"
+    }
+  },
+  "dependencies": {
+    "ajv": "~8.17.1",
+    "js-yaml": "^4.1.0",
+    "semver": "^7.5.2",
+    "tslib": "^2.6.2"
+  },
+  "peerDependencies": {
+    "type-fest": "^4.30.1"
+  },
+  "peerDependenciesMeta": {
+    "type-fest": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@babel/core": "~7.28.0",
+    "@babel/preset-env": "~7.28.0",
+    "@babel/preset-typescript": "~7.28.0",
+    "@compodoc/compodoc": "^1.1.19",
+    "@eslint-community/eslint-plugin-eslint-comments": "^4.4.0",
+    "@nx/eslint": "~21.6.0",
+    "@nx/eslint-plugin": "~21.6.0",
+    "@nx/jest": "~21.6.0",
+    "@nx/js": "~21.6.0",
+    "@o3r/build-helpers": "workspace:~",
+    "@o3r/eslint-plugin": "workspace:~",
+    "@o3r/telemetry": "workspace:~",
+    "@o3r/test-helpers": "workspace:~",
+    "@stylistic/eslint-plugin": "~5.5.0",
+    "@types/jest": "~29.5.2",
+    "@types/js-yaml": "^4.0.5",
+    "@types/minimist": "^1.2.2",
+    "@types/node": "~22.18.0",
+    "@types/semver": "^7.3.13",
+    "@typescript-eslint/parser": "~8.46.0",
+    "angular-eslint": "~20.4.0",
+    "babel-jest": "^29.7.0",
+    "cpy-cli": "^6.0.0",
+    "eslint": "~9.38.0",
+    "eslint-import-resolver-node": "~0.3.9",
+    "eslint-import-resolver-typescript": "~4.4.0",
+    "eslint-plugin-import": "~2.32.0",
+    "eslint-plugin-import-newlines": "~1.4.0",
+    "eslint-plugin-jest": "~29.0.0",
+    "eslint-plugin-jsdoc": "~54.7.0",
+    "eslint-plugin-prefer-arrow": "~1.2.3",
+    "eslint-plugin-unicorn": "~60.0.0",
+    "eslint-plugin-unused-imports": "~4.3.0",
+    "globals": "^16.0.0",
+    "jest": "~29.7.0",
+    "jest-junit": "~16.0.0",
+    "jest-resolve": "~29.7.0",
+    "jest-util": "~29.7.0",
+    "jsonc-eslint-parser": "~2.4.0",
+    "nx": "~21.6.0",
+    "pid-from-port": "^1.1.3",
+    "ts-jest": "~29.4.0",
+    "type-fest": "^4.30.1",
+    "typescript": "~5.9.2",
+    "typescript-eslint": "~8.46.0"
+  },
+  "engines": {
+    "node": "^20.19.0 || ^22.17.0 || ^24.0.0"
+  }
+}

package/renovate/default.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "description": "Default Renovate configuration for @ama-openapi packages",
+  "extends": [
+    "github>AmadeusITGroup/otter//tools/renovate/group/otter"
+  ]
+}

package/schemas/manifest.schema.json

@@ -0,0 +1,106 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "OpenApi specification package manifest",
+  "type": "object",
+  "properties": {
+    "models": {
+      "type": "object",
+      "description": "Dependency package containing the specification to include",
+      "additionalProperties": {
+        "oneOf": [
+          { "$ref": "#/definitions/model" },
+          { "type": "array", "items": { "$ref": "#/definitions/model" } }
+        ]
+      }
+    }
+  },
+  "additionalProperties": true,
+  "definitions": {
+    "transform": {
+      "oneOf": [
+        {
+          "type": "object",
+          "examples": [
+            {
+              "mask": { "data": true },
+              "fileRename": "MyPrefix_$1"
+            }
+          ],
+          "properties": {
+            "mask": {
+              "type": "object",
+              "description": "Mask to apply"
+            },
+            "titleRename": {
+              "type": "string",
+              "description": "Rename the model title. The keyword `$1` can be used to refer to original name (ex: a prefix would be `myPrefix_$1`)"
+            },
+            "fileRename": {
+              "type": "string",
+              "description": "Rename the outputted file (to be specified without extension)."
+            }
+          },
+          "additionalProperties": false,
+          "required": [
+            "fileRename"
+          ]
+        },
+        {
+          "type": "string",
+          "description": "A reference to a predefined transform"
+        }
+      ]
+    },
+    "model": {
+      "examples": [
+        true,
+        "models/ExampleModel.v1.yaml",
+        {
+          "path": "models/ExampleModel.v1.yaml",
+          "transform": {
+            "mask": { "data": true },
+            "fileRename": "MyPrefix_$1"
+          }
+        }
+      ],
+      "oneOf": [
+        {
+          "type": "boolean",
+          "default": true,
+          "description": "Include the default model from the artifact"
+        },
+        {
+          "type": "string",
+          "description": "Path to the model to include as is"
+        },
+        {
+          "type": "object",
+          "description": "Model definition within a dependency",
+          "properties": {
+            "path": {
+              "type": "string",
+              "description": "Path to the model in the artifact"
+            },
+            "transform": {
+              "oneOf": [
+                {
+                  "$ref": "#/definitions/transform"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/definitions/transform"
+                  }
+                }
+              ]
+            }
+          },
+          "required": [
+            "path"
+          ],
+          "additionalProperties": false
+        }
+      ]
+    }
+  }
+}

package/src/constants.d.mts

@@ -0,0 +1,15 @@
+/** Directory containing the extracted module */
+export declare const OUTPUT_DIRECTORY = "models_external";
+/** Default manifest filenames to look for */
+export declare const DEFAULT_MANIFEST_FILENAMES: readonly ["package.json", "ama-openapi.manifest.json", "ama-openapi.manifest.yaml", "openapi.manifest.json", "openapi.manifest.yaml"];
+/** Key to mark masked properties */
+export declare const MASKED_PROPERTY_KEY = "x-internal-masked";
+/** Key to mark touched properties */
+export declare const TOUCHED_PROPERTY_KEY = "x-internal-touched";
+/** Key to indicate the source of the model */
+export declare const SOURCE_PROPERTY_KEY = "x-internal-source";
+/** Key to indicate the version of the model */
+export declare const VERSION_PROPERTY_KEY = "x-internal-version";
+/** Key to indicate reference rewrites */
+export declare const REF_REWRITE_PROPERTY_KEY = "x-internal-reference-rewrite";
+//# sourceMappingURL=constants.d.mts.map

package/src/constants.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.mts","sourceRoot":"","sources":["../../src/constants.mts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,eAAO,MAAM,gBAAgB,oBAAoB,CAAC;AAElD,6CAA6C;AAC7C,eAAO,MAAM,0BAA0B,uIAM7B,CAAC;AAIX,oCAAoC;AACpC,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AACvD,qCAAqC;AACrC,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AACzD,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AACvD,+CAA+C;AAC/C,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AACzD,yCAAyC;AACzC,eAAO,MAAM,wBAAwB,iCAAiC,CAAC"}

package/src/constants.mjs

@@ -0,0 +1,22 @@
+/** Directory containing the extracted module */
+export const OUTPUT_DIRECTORY = 'models_external';
+/** Default manifest filenames to look for */
+export const DEFAULT_MANIFEST_FILENAMES = [
+    'package.json',
+    'ama-openapi.manifest.json',
+    'ama-openapi.manifest.yaml',
+    'openapi.manifest.json',
+    'openapi.manifest.yaml'
+];
+// Internal property keys :
+/** Key to mark masked properties */
+export const MASKED_PROPERTY_KEY = 'x-internal-masked';
+/** Key to mark touched properties */
+export const TOUCHED_PROPERTY_KEY = 'x-internal-touched';
+/** Key to indicate the source of the model */
+export const SOURCE_PROPERTY_KEY = 'x-internal-source';
+/** Key to indicate the version of the model */
+export const VERSION_PROPERTY_KEY = 'x-internal-version';
+/** Key to indicate reference rewrites */
+export const REF_REWRITE_PROPERTY_KEY = 'x-internal-reference-rewrite';
+//# sourceMappingURL=constants.mjs.map

package/src/constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.mjs","sourceRoot":"","sources":["../../src/constants.mts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,MAAM,CAAC,MAAM,gBAAgB,GAAG,iBAAiB,CAAC;AAElD,6CAA6C;AAC7C,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,cAAc;IACd,2BAA2B;IAC3B,2BAA2B;IAC3B,uBAAuB;IACvB,uBAAuB;CACf,CAAC;AAEX,2BAA2B;AAE3B,oCAAoC;AACpC,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AACvD,qCAAqC;AACrC,MAAM,CAAC,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AACzD,8CAA8C;AAC9C,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AACvD,+CAA+C;AAC/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AACzD,yCAAyC;AACzC,MAAM,CAAC,MAAM,wBAAwB,GAAG,8BAA8B,CAAC"}

package/src/core/file-system/cleaner.d.mts

@@ -0,0 +1,6 @@
+/**
+ * Clean the dependency output directory
+ * @param cwd
+ */
+export declare const cleanOutputDirectory: (cwd: string) => Promise<void>;
+//# sourceMappingURL=cleaner.d.mts.map

package/src/core/file-system/cleaner.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleaner.d.mts","sourceRoot":"","sources":["../../../../src/core/file-system/cleaner.mts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,MAAM,kBAE/C,CAAC"}

package/src/core/file-system/cleaner.mjs

@@ -0,0 +1,11 @@
+import { promises as fs, } from 'node:fs';
+import { resolve, } from 'node:path';
+import { OUTPUT_DIRECTORY, } from '../../constants.mjs';
+/**
+ * Clean the dependency output directory
+ * @param cwd
+ */
+export const cleanOutputDirectory = (cwd) => {
+    return fs.rm(resolve(cwd, OUTPUT_DIRECTORY), { force: true, recursive: true });
+};
+//# sourceMappingURL=cleaner.mjs.map

package/src/core/file-system/cleaner.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleaner.mjs","sourceRoot":"","sources":["../../../../src/core/file-system/cleaner.mts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,IAAI,EAAE,GACf,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,OAAO,GACR,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAE7B;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,GAAW,EAAE,EAAE;IAClD,OAAO,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,gBAAgB,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACjF,CAAC,CAAC"}

package/src/core/file-system/parse-file.d.mts

@@ -0,0 +1,11 @@
+/**
+ * Check if the file is a JSON file
+ * @param filePath
+ */
+export declare const isJsonFile: (filePath: string) => boolean;
+/**
+ *n Parse a file content based on its extension
+ * @param filePath
+ */
+export declare const parseFile: <S>(filePath: string) => Promise<S>;
+//# sourceMappingURL=parse-file.d.mts.map

package/src/core/file-system/parse-file.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-file.d.mts","sourceRoot":"","sources":["../../../../src/core/file-system/parse-file.mts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,UAAU,MAAM,KAAG,OAE7C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAU,CAAC,EAAG,UAAU,MAAM,KAAG,OAAO,CAAC,CAAC,CAK/D,CAAC"}

package/src/core/file-system/parse-file.mjs

@@ -0,0 +1,20 @@
+import { promises as fs, } from 'node:fs';
+import { load, } from 'js-yaml';
+/**
+ * Check if the file is a JSON file
+ * @param filePath
+ */
+export const isJsonFile = (filePath) => {
+    return filePath.toLowerCase().endsWith('.json');
+};
+/**
+ *n Parse a file content based on its extension
+ * @param filePath
+ */
+export const parseFile = async (filePath) => {
+    const content = await fs.readFile(filePath, { encoding: 'utf8' });
+    return (isJsonFile(filePath)
+        ? JSON.parse(content)
+        : load(content));
+};
+//# sourceMappingURL=parse-file.mjs.map

package/src/core/file-system/parse-file.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-file.mjs","sourceRoot":"","sources":["../../../../src/core/file-system/parse-file.mts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,IAAI,EAAE,GACf,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,IAAI,GACL,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAW,EAAE;IACtD,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAClD,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAM,QAAgB,EAAc,EAAE;IAClE,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAClE,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC;QAC1B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACrB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAM,CAAC;AAC1B,CAAC,CAAC"}

package/src/core/file-system/write-model.d.mts

@@ -0,0 +1,7 @@
+import type { RetrievedDependencyModel } from '../manifest/extract-dependency-models.mjs';
+/**
+ * Write the model file in the dependencies folder.
+ * @param retrievedModel
+ */
+export declare const writeModelFile: (retrievedModel: RetrievedDependencyModel) => Promise<void>;
+//# sourceMappingURL=write-model.d.mts.map

package/src/core/file-system/write-model.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-model.d.mts","sourceRoot":"","sources":["../../../../src/core/file-system/write-model.mts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,wBAAwB,EACzB,MAAM,2CAA2C,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAU,gBAAgB,wBAAwB,kBAS5E,CAAC"}

package/src/core/file-system/write-model.mjs

@@ -0,0 +1,17 @@
+import { promises as fs, } from 'node:fs';
+import { dirname, } from 'node:path';
+/**
+ * Write the model file in the dependencies folder.
+ * @param retrievedModel
+ */
+export const writeModelFile = async (retrievedModel) => {
+    const { outputFilePath, content } = retrievedModel;
+    try {
+        await fs.mkdir(dirname(outputFilePath), { recursive: true });
+    }
+    catch {
+        // ignore folder creation failure because it can be due to existing one. If not the next command will fail.
+    }
+    await fs.writeFile(outputFilePath, content, { encoding: 'utf8' });
+};
+//# sourceMappingURL=write-model.mjs.map

package/src/core/file-system/write-model.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-model.mjs","sourceRoot":"","sources":["../../../../src/core/file-system/write-model.mts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,IAAI,EAAE,GACf,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,OAAO,GACR,MAAM,WAAW,CAAC;AAKnB;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,cAAwC,EAAE,EAAE;IAC/E,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,cAAc,CAAC;IACnD,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,2GAA2G;IAC7G,CAAC;IAED,MAAM,EAAE,CAAC,SAAS,CAAC,cAAc,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;AACpE,CAAC,CAAC"}

package/src/core/manifest/extract-dependency-models.d.mts

@@ -0,0 +1,35 @@
+import type { Logger } from '../../logger.mjs';
+import type { Manifest, Model, Transform } from './manifest.mjs';
+/**
+ * Extracted dependency model information
+ */
+export interface RetrievedDependencyModel {
+    /** Name of the artifact */
+    artifactName: string;
+    /** Version of the artifact */
+    version: string;
+    /** Absolute path to the model file */
+    modelPath: string;
+    /** Content of the model file */
+    content: string;
+    /** Model definition from the manifest */
+    model: Model & {
+        path: string;
+    };
+    /** Indicates if the model file is a JSON file */
+    isJson: boolean;
+    /** Absolute path to the artifact root folder */
+    artifactBasePath: string;
+    /** Absolute path to the output for the generated file */
+    outputFilePath: string;
+    /** Mask to apply */
+    transform?: Transform;
+}
+/**
+ * Extract dependency models from the manifest
+ * @param cwd
+ * @param manifest
+ * @param _logger
+ */
+export declare const extractDependencyModels: (cwd: string, manifest: Manifest, _logger?: Logger) => Promise<RetrievedDependencyModel>[];
+//# sourceMappingURL=extract-dependency-models.d.mts.map

package/src/core/manifest/extract-dependency-models.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-dependency-models.d.mts","sourceRoot":"","sources":["../../../../src/core/manifest/extract-dependency-models.mts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EACV,MAAM,EACP,MAAM,kBAAkB,CAAC;AAI1B,OAAO,KAAK,EACV,QAAQ,EACR,KAAK,EACL,SAAS,EACV,MAAM,gBAAgB,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,KAAK,EAAE,KAAK,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,iDAAiD;IACjD,MAAM,EAAE,OAAO,CAAC;IAChB,gDAAgD;IAChD,gBAAgB,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB;IACpB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAiGD;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAAI,KAAK,MAAM,EAAE,UAAU,QAAQ,EAAE,UAAU,MAAM,wCAUxF,CAAC"}

package/src/core/manifest/extract-dependency-models.mjs

@@ -0,0 +1,112 @@
+import { promises as fs, } from 'node:fs';
+import { createRequire, } from 'node:module';
+import { basename, dirname, extname, join, resolve, } from 'node:path';
+import { load, } from 'js-yaml';
+import { OUTPUT_DIRECTORY, } from '../../constants.mjs';
+import { isJsonFile, } from '../file-system/parse-file.mjs';
+const require = createRequire(import.meta.url);
+/**
+ * Sanitize the package path to be used in file system
+ * @param artifactName
+ */
+const sanitizePackagePath = (artifactName) => {
+    return artifactName
+        .replace('/', '-')
+        .replace(/^@/, '');
+};
+/**
+ * Retrieve the transform object from the manifest
+ * @param cwd
+ * @param transform
+ */
+const retrieveTransform = async (cwd, transform) => {
+    if (typeof transform === 'string') {
+        const transformPath = resolve(cwd, transform);
+        const fileContent = await fs.readFile(transformPath, { encoding: 'utf8' });
+        return extname(transformPath).toLowerCase() === '.json'
+            ? JSON.parse(fileContent)
+            : load(fileContent);
+    }
+    return transform;
+};
+/**
+ * Extract dependency model given simple model definition (as string or boolean)
+ * @param cwd
+ * @param artifactName
+ * @param modelName
+ */
+const extractDependencyModelsSimple = async (cwd, artifactName, modelName) => {
+    const artifactPackageJson = require.resolve(`${artifactName}/package.json`);
+    const artifactBasePath = dirname(artifactPackageJson);
+    const modelPath = typeof modelName === 'string' ? join(artifactBasePath, modelName) : require.resolve(artifactName);
+    const version = await fs.readFile(artifactPackageJson, { encoding: 'utf8' }).then((data) => JSON.parse(data).version || 'latest');
+    const content = await fs.readFile(modelPath, { encoding: 'utf8' });
+    const path = typeof modelName === 'string' ? modelName : artifactName;
+    const model = { path };
+    const outputFilePath = resolve(cwd, OUTPUT_DIRECTORY, sanitizePackagePath(artifactName), model.path);
+    return {
+        outputFilePath,
+        artifactBasePath,
+        artifactName,
+        modelPath,
+        version,
+        content,
+        model: {
+            path
+        },
+        isJson: isJsonFile(modelPath)
+    };
+};
+/**
+ * Extract dependency model given full model definition
+ * @param cwd
+ * @param artifactName
+ * @param model
+ * @param transformPromise
+ */
+const extractDependencyModelsObject = async (cwd, artifactName, model, transformPromise) => {
+    const transform = await transformPromise;
+    const artifactPackageJson = require.resolve(`${artifactName}/package.json`);
+    const artifactBasePath = dirname(artifactPackageJson);
+    const modelPath = model.path ? join(artifactBasePath, model.path) : require.resolve(artifactName);
+    const version = await fs.readFile(artifactPackageJson, { encoding: 'utf8' }).then((data) => JSON.parse(data).version || 'latest');
+    const content = await fs.readFile(modelPath, { encoding: 'utf8' });
+    const defaultSpec = require.resolve(artifactName).split(artifactName)[1];
+    const path = model.path || defaultSpec;
+    const fileExtension = extname(path);
+    const replaceName = transform?.fileRename && path.replace(new RegExp(`(${basename(path, fileExtension)})${fileExtension}$`), transform.fileRename + fileExtension);
+    const fileNameOutput = replaceName || path;
+    const outputFilePath = resolve(cwd, OUTPUT_DIRECTORY, sanitizePackagePath(artifactName), fileNameOutput);
+    return {
+        transform,
+        outputFilePath,
+        artifactBasePath,
+        artifactName,
+        modelPath,
+        version,
+        content,
+        model: {
+            ...model,
+            path
+        },
+        isJson: isJsonFile(modelPath)
+    };
+};
+/**
+ * Extract dependency models from the manifest
+ * @param cwd
+ * @param manifest
+ * @param _logger
+ */
+export const extractDependencyModels = (cwd, manifest, _logger) => {
+    return Object.entries(manifest.models).flatMap(([dependencyName, modelDefinition]) => {
+        const models = Array.isArray(modelDefinition) ? modelDefinition : [modelDefinition];
+        return models
+            .flatMap((model) => typeof model === 'string' || typeof model === 'boolean'
+            ? [extractDependencyModelsSimple(cwd, dependencyName, model)]
+            : (Array.isArray(model.transform)
+                ? (model.transform.length > 0 ? model.transform : [undefined]).map((transform) => extractDependencyModelsObject(cwd, dependencyName, model, retrieveTransform(cwd, transform)))
+                : [extractDependencyModelsObject(cwd, dependencyName, model, retrieveTransform(cwd, model.transform))]));
+    });
+};
+//# sourceMappingURL=extract-dependency-models.mjs.map

package/src/core/manifest/extract-dependency-models.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-dependency-models.mjs","sourceRoot":"","sources":["../../../../src/core/manifest/extract-dependency-models.mts"],"names":[],"mappings":"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"}

package/src/core/manifest/manifest.d.mts

@@ -0,0 +1,46 @@
+import type { PackageJson } from 'type-fest';
+import type { Logger } from '../../logger.mjs';
+/**
+ * Mask object for filtering properties
+ */
+export interface Mask {
+    properties?: Record<string, any>;
+    [x: string]: any;
+}
+export interface Transform {
+    /** Mask to apply */
+    mask?: Mask;
+    /** Rename the model */
+    titleRename?: string;
+    /** Rename the outputted file (without extension) */
+    fileRename: string;
+}
+type TransformOrReference = Transform | string;
+/**
+ * Model definition within a dependency
+ */
+export interface Model {
+    /** Path to the model in the artifact */
+    path?: string;
+    /**
+     * Transforms to apply to the model
+     * Note that for each transform object, a new definition will be generated
+     */
+    transform?: TransformOrReference | TransformOrReference[];
+}
+/** List of supported types for an Model */
+export type SupportedModelTypes = string | Model | boolean;
+/** Models dependencies */
+export type Models = Record<string, SupportedModelTypes | SupportedModelTypes[]>;
+/** Manifest file structure */
+export type Manifest = PackageJson & {
+    models: Models;
+};
+/**
+ * Retrieve Manifest file
+ * @param workspaceDirectory
+ * @param logger
+ */
+export declare const retrieveManifest: (workspaceDirectory: string, logger?: Logger) => Promise<Manifest | undefined>;
+export {};
+//# sourceMappingURL=manifest.d.mts.map

package/src/core/manifest/manifest.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.mts","sourceRoot":"","sources":["../../../../src/core/manifest/manifest.mts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,WAAW,EACZ,MAAM,WAAW,CAAC;AAInB,OAAO,KAAK,EACV,MAAM,EACP,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,oBAAoB;IACpB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,KAAK,oBAAoB,GAAG,SAAS,GAAG,MAAM,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,SAAS,CAAC,EAAE,oBAAoB,GAAG,oBAAoB,EAAE,CAAC;CAC3D;AAED,2CAA2C;AAC3C,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;AAE3D,0BAA0B;AAC1B,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,mBAAmB,EAAE,CAAC,CAAC;AAEjF,8BAA8B;AAC9B,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AA2BxD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAU,oBAAoB,MAAM,EAAE,SAAQ,MAAgB,KAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAoBzH,CAAC"}

package/src/core/manifest/manifest.mjs

@@ -0,0 +1,55 @@
+import { existsSync, promises as fs, } from 'node:fs';
+import { extname, resolve, } from 'node:path';
+import { fileURLToPath, } from 'node:url';
+import { Ajv, } from 'ajv';
+import { load, } from 'js-yaml';
+import { DEFAULT_MANIFEST_FILENAMES, } from '../../constants.mjs';
+/**
+ * Validate the manifest file
+ * @param manifest
+ * @param manifestPath
+ * @param logger
+ */
+const isValidManifest = async (manifest, manifestPath, logger) => {
+    if (!manifest || (typeof manifest === 'object' && !('models' in manifest))) {
+        return false;
+    }
+    const ajv = new Ajv();
+    const schemaPath = resolve(fileURLToPath(new URL('.', import.meta.url)), '..', '..', 'schemas', 'manifest.schema.json');
+    const schema = JSON.parse(await fs.readFile(schemaPath, { encoding: 'utf8' }));
+    const validate = ajv.compile(schema);
+    const isValid = validate(manifest);
+    if (!isValid) {
+        logger.error(`${manifestPath} is invalid. Errors:`);
+        logger.error(validate.errors);
+        throw new Error('Invalid models definitions');
+    }
+    return true;
+};
+/**
+ * Retrieve Manifest file
+ * @param workspaceDirectory
+ * @param logger
+ */
+export const retrieveManifest = async (workspaceDirectory, logger = console) => {
+    for (const manifestFileName of DEFAULT_MANIFEST_FILENAMES) {
+        const manifestPath = resolve(workspaceDirectory, manifestFileName);
+        if (!existsSync(manifestPath)) {
+            logger.debug?.(`Manifest file not found at ${manifestPath}`);
+            continue;
+        }
+        const content = await fs.readFile(manifestPath, { encoding: 'utf8' });
+        const manifest = (extname(manifestPath).toLowerCase() === '.json'
+            ? JSON.parse(content)
+            : load(content));
+        if (await isValidManifest(manifest, manifestPath, logger)) {
+            logger.info?.(`Manifest file found at ${manifestPath}`);
+            return manifest;
+        }
+        else {
+            logger.debug?.(`Manifest file at ${manifestPath} is not conform to the expected schema`);
+        }
+    }
+    return undefined;
+};
+//# sourceMappingURL=manifest.mjs.map

package/src/core/manifest/manifest.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.mjs","sourceRoot":"","sources":["../../../../src/core/manifest/manifest.mts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,QAAQ,IAAI,EAAE,GACf,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,OAAO,EACP,OAAO,GACR,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,aAAa,GACd,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,GAAG,GACJ,MAAM,KAAK,CAAC;AACb,OAAO,EACL,IAAI,GACL,MAAM,SAAS,CAAC;AAIjB,OAAO,EACL,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AA+C7B;;;;;GAKG;AACH,MAAM,eAAe,GAAG,KAAK,EAAE,QAAa,EAAE,YAAoB,EAAE,MAAc,EAAoB,EAAE;IACtG,IAAI,CAAC,QAAQ,IAAI,CAAC,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,IAAI,QAAQ,CAAC,CAAC,EAAE,CAAC;QAC3E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;IACtB,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,sBAAsB,CAAC,CAAC;IACxH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAW,CAAC;IACzF,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAEnC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,sBAAsB,CAAC,CAAC;QACpD,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,kBAA0B,EAAE,SAAiB,OAAO,EAAiC,EAAE;IAC5H,KAAK,MAAM,gBAAgB,IAAI,0BAA0B,EAAE,CAAC;QAC1D,MAAM,YAAY,GAAG,OAAO,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;QACnE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,KAAK,EAAE,CAAC,8BAA8B,YAAY,EAAE,CAAC,CAAC;YAC7D,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACtE,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,KAAK,OAAO;YAC/D,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;YACrB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAa,CAAC;QAC/B,IAAI,MAAM,eAAe,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,CAAC;YAC1D,MAAM,CAAC,IAAI,EAAE,CAAC,0BAA0B,YAAY,EAAE,CAAC,CAAC;YACxD,OAAO,QAAQ,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,EAAE,CAAC,oBAAoB,YAAY,wCAAwC,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC"}

package/src/core/serialization.d.mts

@@ -0,0 +1,14 @@
+import type { RetrievedDependencyModel } from './manifest/extract-dependency-models.mjs';
+/**
+ * Deserialize the content of a model file
+ * @param specification
+ * @param model
+ */
+export declare const deserialize: (specification: string, model: RetrievedDependencyModel) => any;
+/**
+ * Serialize an object into a model file content
+ * @param specification
+ * @param model
+ */
+export declare const serialize: (specification: any, model: RetrievedDependencyModel) => string;
+//# sourceMappingURL=serialization.d.mts.map

package/src/core/serialization.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.mts","sourceRoot":"","sources":["../../../src/core/serialization.mts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,wBAAwB,EACzB,MAAM,0CAA0C,CAAC;AAElD;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,eAAe,MAAM,EAAE,OAAO,wBAAwB,KAAG,GAKpF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,eAAe,GAAG,EAAE,OAAO,wBAAwB,KAAG,MAK/E,CAAC"}

package/src/core/serialization.mjs

@@ -0,0 +1,24 @@
+import { dump, load, } from 'js-yaml';
+/**
+ * Deserialize the content of a model file
+ * @param specification
+ * @param model
+ */
+export const deserialize = (specification, model) => {
+    if (model.isJson) {
+        return JSON.parse(specification);
+    }
+    return load(specification);
+};
+/**
+ * Serialize an object into a model file content
+ * @param specification
+ * @param model
+ */
+export const serialize = (specification, model) => {
+    if (model.isJson) {
+        return JSON.stringify(specification, null, 2);
+    }
+    return dump(specification);
+};
+//# sourceMappingURL=serialization.mjs.map

package/src/core/serialization.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.mjs","sourceRoot":"","sources":["../../../src/core/serialization.mts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,IAAI,GACL,MAAM,SAAS,CAAC;AAKjB;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,aAAqB,EAAE,KAA+B,EAAO,EAAE;IACzF,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,IAAI,CAAC,aAAa,CAAC,CAAC;AAC7B,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,aAAkB,EAAE,KAA+B,EAAU,EAAE;IACvF,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,IAAI,CAAC,aAAa,CAAC,CAAC;AAC7B,CAAC,CAAC"}

package/src/core/transforms/add-annotation.d.mts

@@ -0,0 +1,18 @@
+import { MASKED_PROPERTY_KEY, SOURCE_PROPERTY_KEY, TOUCHED_PROPERTY_KEY, VERSION_PROPERTY_KEY } from '../../constants.mjs';
+import type { Logger } from '../../logger.mjs';
+import type { RetrievedDependencyModel } from '../manifest/extract-dependency-models.mjs';
+type AdditionalAnnotation = {
+    [MASKED_PROPERTY_KEY]: boolean;
+    [TOUCHED_PROPERTY_KEY]: boolean;
+    [SOURCE_PROPERTY_KEY]: string;
+    [VERSION_PROPERTY_KEY]: string;
+};
+/**
+ * Add annotation to the specification indicating its source, version, and if it was masked
+ * @param specification
+ * @param retrievedModel
+ * @param _logger
+ */
+export declare const addAnnotation: <S extends object>(specification: S, retrievedModel: RetrievedDependencyModel, _logger?: Logger) => S & AdditionalAnnotation;
+export {};
+//# sourceMappingURL=add-annotation.d.mts.map

package/src/core/transforms/add-annotation.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-annotation.d.mts","sourceRoot":"","sources":["../../../../src/core/transforms/add-annotation.mts"],"names":[],"mappings":"AAGA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,MAAM,EACP,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,wBAAwB,EACzB,MAAM,2CAA2C,CAAC;AAEnD,KAAK,oBAAoB,GAAG;IAC1B,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC/B,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAChC,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC9B,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,MAAM,EAAE,eAAe,CAAC,EAAE,gBAAgB,wBAAwB,EAAE,UAAU,MAAM,KAAG,CAAC,GAAG,oBASlI,CAAC"}

package/src/core/transforms/add-annotation.mjs

@@ -0,0 +1,19 @@
+import { posix, } from 'node:path';
+import { MASKED_PROPERTY_KEY, SOURCE_PROPERTY_KEY, TOUCHED_PROPERTY_KEY, VERSION_PROPERTY_KEY, } from '../../constants.mjs';
+/**
+ * Add annotation to the specification indicating its source, version, and if it was masked
+ * @param specification
+ * @param retrievedModel
+ * @param _logger
+ */
+export const addAnnotation = (specification, retrievedModel, _logger) => {
+    const { artifactName, version, transform } = retrievedModel;
+    return {
+        ...specification,
+        [SOURCE_PROPERTY_KEY]: posix.join(artifactName, retrievedModel.model.path),
+        [VERSION_PROPERTY_KEY]: version,
+        [MASKED_PROPERTY_KEY]: !!transform?.mask,
+        [TOUCHED_PROPERTY_KEY]: !!transform
+    };
+};
+//# sourceMappingURL=add-annotation.mjs.map

package/src/core/transforms/add-annotation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-annotation.mjs","sourceRoot":"","sources":["../../../../src/core/transforms/add-annotation.mts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,GACN,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAe7B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAmB,aAAgB,EAAE,cAAwC,EAAE,OAAgB,EAA4B,EAAE;IACxJ,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,cAAc,CAAC;IAC5D,OAAO;QACL,GAAG,aAAa;QAChB,CAAC,mBAAmB,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC;QAC1E,CAAC,oBAAoB,CAAC,EAAE,OAAO;QAC/B,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC,SAAS,EAAE,IAAI;QACxC,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC,SAAS;KACpC,CAAC;AACJ,CAAC,CAAC"}

package/src/core/transforms/apply-mask.d.mts

@@ -0,0 +1,10 @@
+import type { Logger } from '../../logger.mjs';
+import type { RetrievedDependencyModel } from '../manifest/extract-dependency-models.mjs';
+/**
+ * Apply the mask to the model
+ * @param specification
+ * @param retrievedModel
+ * @param _logger
+ */
+export declare const applyMask: <S extends object>(specification: S, retrievedModel: RetrievedDependencyModel, _logger?: Logger) => S;
+//# sourceMappingURL=apply-mask.d.mts.map

package/src/core/transforms/apply-mask.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-mask.d.mts","sourceRoot":"","sources":["../../../../src/core/transforms/apply-mask.mts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,MAAM,EACP,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,wBAAwB,EACzB,MAAM,2CAA2C,CAAC;AAqDnD;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,MAAM,EAAE,eAAe,CAAC,EAAE,gBAAgB,wBAAwB,EAAE,UAAU,MAAM,KAAG,CAK1H,CAAC"}

package/src/core/transforms/apply-mask.mjs

@@ -0,0 +1,57 @@
+/* eslint-disable @typescript-eslint/no-unsafe-argument -- due to unknown object structure */
+/* eslint-disable @typescript-eslint/no-unsafe-member-access -- due to unknown object structure */
+/* eslint-disable @typescript-eslint/no-unsafe-assignment -- due to unknown object structure */
+/**
+ * Recursively apply the mask to model properties
+ * @param modelProperties
+ * @param maskProperties
+ */
+const maskModelProperties = (modelProperties, maskProperties) => {
+    return Object.fromEntries(Object.entries(modelProperties)
+        .filter(([key]) => !!maskProperties && key in maskProperties && maskProperties[key] !== false)
+        .map(([key, value]) => typeof maskProperties[key] === 'object' ? [key, maskModelProperties(value, maskProperties[key])] : [key, value]));
+};
+/**
+ * Recursively apply the sub-mask to the specification
+ * @param specification
+ * @param mask
+ */
+const applySubMask = (specification, mask) => {
+    const result = { ...specification };
+    if (!mask || typeof mask !== 'object') {
+        return result;
+    }
+    if ('properties' in mask && 'properties' in result) {
+        result.properties = maskModelProperties(result.properties, mask.properties);
+    }
+    const maskAdditionalProperties = Object.entries(mask)
+        .filter(([key]) => key !== 'properties');
+    if (maskAdditionalProperties.length > 0) {
+        delete result.type;
+        delete result.properties;
+        for (const [key, value] of maskAdditionalProperties) {
+            if (typeof value === 'object') {
+                result[key] = Array.isArray(value)
+                    ? value.map((subMask) => applyMask(result[key], subMask))
+                    : value && Object.fromEntries(Object.entries(value).map(([maskKey, subMask]) => ([maskKey, applyMask(result[key][maskKey], subMask)])));
+            }
+            else {
+                result[key] = value;
+            }
+        }
+    }
+    return result;
+};
+/**
+ * Apply the mask to the model
+ * @param specification
+ * @param retrievedModel
+ * @param _logger
+ */
+export const applyMask = (specification, retrievedModel, _logger) => {
+    if (!retrievedModel.transform) {
+        return specification;
+    }
+    return applySubMask(specification, retrievedModel.transform.mask);
+};
+//# sourceMappingURL=apply-mask.mjs.map

package/src/core/transforms/apply-mask.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-mask.mjs","sourceRoot":"","sources":["../../../../src/core/transforms/apply-mask.mts"],"names":[],"mappings":"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"}

package/src/core/transforms/rename.d.mts

@@ -0,0 +1,10 @@
+import type { Logger } from '../../logger.mjs';
+import type { RetrievedDependencyModel } from '../manifest/extract-dependency-models.mjs';
+/**
+ * Rename the title of the specification
+ * @param specification
+ * @param retrievedModel
+ * @param _logger
+ */
+export declare const renameTitle: <S extends object>(specification: S, retrievedModel: RetrievedDependencyModel, _logger?: Logger) => S;
+//# sourceMappingURL=rename.d.mts.map

package/src/core/transforms/rename.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename.d.mts","sourceRoot":"","sources":["../../../../src/core/transforms/rename.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACP,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,wBAAwB,EACzB,MAAM,2CAA2C,CAAC;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,MAAM,EAAE,eAAe,CAAC,EAAE,gBAAgB,wBAAwB,EAAE,UAAU,MAAM,KAAG,CAU5H,CAAC"}

package/src/core/transforms/rename.mjs

@@ -0,0 +1,18 @@
+/**
+ * Rename the title of the specification
+ * @param specification
+ * @param retrievedModel
+ * @param _logger
+ */
+export const renameTitle = (specification, retrievedModel, _logger) => {
+    if (retrievedModel.transform?.titleRename) {
+        let title = 'title' in specification ? specification.title : undefined;
+        title = title && title.replace(new RegExp(`^(${title})$`), retrievedModel.transform.titleRename);
+        specification = {
+            ...specification,
+            title
+        };
+    }
+    return specification;
+};
+//# sourceMappingURL=rename.mjs.map

package/src/core/transforms/rename.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename.mjs","sourceRoot":"","sources":["../../../../src/core/transforms/rename.mts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAmB,aAAgB,EAAE,cAAwC,EAAE,OAAgB,EAAK,EAAE;IAC/H,IAAI,cAAc,CAAC,SAAS,EAAE,WAAW,EAAE,CAAC;QAC1C,IAAI,KAAK,GAAuB,OAAO,IAAI,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,KAAe,CAAC,CAAC,CAAC,SAAS,CAAC;QACrG,KAAK,GAAG,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACjG,aAAa,GAAG;YACd,GAAG,aAAa;YAChB,KAAK;SACN,CAAC;IACJ,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC,CAAC"}

package/src/core/transforms/to-reference.d.mts

@@ -0,0 +1,16 @@
+import type { Logger } from '../../logger.mjs';
+import type { RetrievedDependencyModel } from '../manifest/extract-dependency-models.mjs';
+type ReferenceSpecification = {
+    $ref: string;
+    [x: string]: any;
+};
+/**
+ * Transform the specification to a single reference if no transformation required
+ * The process will keep the x-vendor properties from the retrieved model
+ * @param specification
+ * @param retrievedModel
+ * @param logger
+ */
+export declare const toReference: <S extends object>(specification: S, retrievedModel: RetrievedDependencyModel, logger?: Logger) => S | ReferenceSpecification;
+export {};
+//# sourceMappingURL=to-reference.d.mts.map

package/src/core/transforms/to-reference.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-reference.d.mts","sourceRoot":"","sources":["../../../../src/core/transforms/to-reference.mts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,MAAM,EACP,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,wBAAwB,EACzB,MAAM,2CAA2C,CAAC;AAEnD,KAAK,sBAAsB,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;CAClB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,MAAM,EAAE,eAAe,CAAC,EAAE,gBAAgB,wBAAwB,EAAE,SAAS,MAAM,KAAG,CAAC,GAAG,sBAU/H,CAAC"}

package/src/core/transforms/to-reference.mjs

@@ -0,0 +1,19 @@
+import { relative, } from 'node:path';
+/**
+ * Transform the specification to a single reference if no transformation required
+ * The process will keep the x-vendor properties from the retrieved model
+ * @param specification
+ * @param retrievedModel
+ * @param logger
+ */
+export const toReference = (specification, retrievedModel, logger) => {
+    if (retrievedModel.transform) {
+        logger?.debug?.(`The specification ${retrievedModel.modelPath} has transform, the conversion to reference will be ignored`);
+        return specification;
+    }
+    return {
+        $ref: relative(retrievedModel.outputFilePath, retrievedModel.modelPath),
+        ...Object.fromEntries(Object.entries(retrievedModel).filter(([key]) => key.startsWith('x-')))
+    };
+};
+//# sourceMappingURL=to-reference.mjs.map

package/src/core/transforms/to-reference.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-reference.mjs","sourceRoot":"","sources":["../../../../src/core/transforms/to-reference.mts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,GACT,MAAM,WAAW,CAAC;AAanB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAmB,aAAgB,EAAE,cAAwC,EAAE,MAAe,EAA8B,EAAE;IACvJ,IAAI,cAAc,CAAC,SAAS,EAAE,CAAC;QAC7B,MAAM,EAAE,KAAK,EAAE,CAAC,qBAAqB,cAAc,CAAC,SAAS,6DAA6D,CAAC,CAAC;QAC5H,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC,cAAc,EAAE,cAAc,CAAC,SAAS,CAAC;QACvE,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;KAC9F,CAAC;AACJ,CAAC,CAAC"}

package/src/core/transforms/transform.d.mts

@@ -0,0 +1,7 @@
+import type { Logger } from '../../logger.mjs';
+import type { RetrievedDependencyModel } from '../manifest/extract-dependency-models.mjs';
+/**
+ * Transform a specification with specified transformation function
+ */
+export type Transform<S extends object = object, T = any> = (specification: S, retrievedModel: RetrievedDependencyModel, logger?: Logger) => T | Promise<T>;
+//# sourceMappingURL=transform.d.mts.map

package/src/core/transforms/transform.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.mts","sourceRoot":"","sources":["../../../../src/core/transforms/transform.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACP,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,wBAAwB,EACzB,MAAM,2CAA2C,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC"}

package/src/core/transforms/transform.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transform.mjs.map

package/src/core/transforms/transform.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.mjs","sourceRoot":"","sources":["../../../../src/core/transforms/transform.mts"],"names":[],"mappings":""}

package/src/core/transforms/update-references.d.mts

@@ -0,0 +1,15 @@
+import { REF_REWRITE_PROPERTY_KEY } from '../../constants.mjs';
+import type { Logger } from '../../logger.mjs';
+import type { RetrievedDependencyModel } from '../manifest/extract-dependency-models.mjs';
+type AdditionalAnnotation = {
+    [REF_REWRITE_PROPERTY_KEY]: boolean;
+};
+/**
+ * Update the $ref references in the specification to be relative to the model path
+ * @param specification
+ * @param receivedModel
+ * @param _logger
+ */
+export declare const updateReferences: <S extends object>(specification: S, receivedModel: RetrievedDependencyModel, _logger?: Logger) => S & AdditionalAnnotation;
+export {};
+//# sourceMappingURL=update-references.d.mts.map

package/src/core/transforms/update-references.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-references.d.mts","sourceRoot":"","sources":["../../../../src/core/transforms/update-references.mts"],"names":[],"mappings":"AAQA,OAAO,EACL,wBAAwB,EACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,MAAM,EACP,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,wBAAwB,EACzB,MAAM,2CAA2C,CAAC;AAMnD,KAAK,oBAAoB,GAAG;IAC1B,CAAC,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACrC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,MAAM,EAAE,eAAe,CAAC,EAAE,eAAe,wBAAwB,EAAE,UAAU,MAAM,KAAG,CAAC,GAAG,oBA4BpI,CAAC"}

package/src/core/transforms/update-references.mjs

@@ -0,0 +1,39 @@
+import { isAbsolute, resolve, } from 'node:path';
+import { dirname, relative, } from 'node:path/posix';
+import { REF_REWRITE_PROPERTY_KEY, } from '../../constants.mjs';
+const isRelativePath = (path) => {
+    return !URL.canParse(path) && !isAbsolute(path);
+};
+/**
+ * Update the $ref references in the specification to be relative to the model path
+ * @param specification
+ * @param receivedModel
+ * @param _logger
+ */
+export const updateReferences = (specification, receivedModel, _logger) => {
+    let hasTouchedReference = false;
+    const walkSpecification = (specItem) => {
+        if (typeof specItem === 'object') {
+            if (specItem === null) {
+                return specItem;
+            }
+            if (Array.isArray(specItem)) {
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-return -- due to unknown object structure
+                return specItem.map((item) => walkSpecification(item));
+            }
+            return Object.fromEntries(Object.entries(specItem).map(([key, value]) => {
+                if (key === '$ref' && typeof value === 'string' && isRelativePath(value)) {
+                    value = relative(dirname(receivedModel.outputFilePath), resolve(dirname(receivedModel.modelPath), value));
+                    hasTouchedReference = true;
+                }
+                return [key, walkSpecification(value)];
+            }));
+        }
+        return specItem;
+    };
+    return {
+        ...walkSpecification(specification),
+        [REF_REWRITE_PROPERTY_KEY]: hasTouchedReference
+    };
+};
+//# sourceMappingURL=update-references.mjs.map

package/src/core/transforms/update-references.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-references.mjs","sourceRoot":"","sources":["../../../../src/core/transforms/update-references.mts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,OAAO,GACR,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,OAAO,EACP,QAAQ,GACT,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAQ7B,MAAM,cAAc,GAAG,CAAC,IAAY,EAAW,EAAE;IAC/C,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AAClD,CAAC,CAAC;AAMF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAmB,aAAgB,EAAE,aAAuC,EAAE,OAAgB,EAA4B,EAAE;IAC1J,IAAI,mBAAmB,GAAG,KAAK,CAAC;IAChC,MAAM,iBAAiB,GAAG,CAAK,QAAW,EAAK,EAAE;QAC/C,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACtB,OAAO,QAAQ,CAAC;YAClB,CAAC;YAED,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5B,kGAAkG;gBAClG,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAM,CAAC;YAC9D,CAAC;YAED,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,QAAkB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;gBAChF,IAAI,GAAG,KAAK,MAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;oBACzE,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;oBAC1G,mBAAmB,GAAG,IAAI,CAAC;gBAC7B,CAAC;gBACD,OAAO,CAAC,GAAG,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;YACzC,CAAC,CAAC,CAAM,CAAC;QACX,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO;QACL,GAAG,iBAAiB,CAAC,aAAa,CAAC;QACnC,CAAC,wBAAwB,CAAC,EAAE,mBAAmB;KAChD,CAAC;AACJ,CAAC,CAAC"}

package/src/logger.d.mts

@@ -0,0 +1,36 @@
+/**
+ * Logger Client interface.
+ */
+export interface Logger {
+    /**
+     * Log an error.
+     * @param message Message to log
+     * @param optionalParams Optional parameters to log
+     */
+    error(message?: any, ...optionalParams: any[]): void;
+    /**
+     * Log a warning.
+     * @param message Message to log
+     * @param optionalParams Optional parameters to log
+     */
+    warn(message?: any, ...optionalParams: any[]): void;
+    /**
+     * Log a message.
+     * @param message Message to log
+     * @param optionalParams Optional parameters to log
+     */
+    info(message?: any, ...optionalParams: any[]): void;
+    /**
+     * Log a message.
+     * @param message Message to log
+     * @param optionalParams Optional parameters to log
+     */
+    log(message?: any, ...optionalParams: any[]): void;
+    /**
+     * Log a debug message.
+     * @param message Message to log
+     * @param optionalParams Optional parameters to log
+     */
+    debug?(message?: any, ...optionalParams: any[]): void;
+}
+//# sourceMappingURL=logger.d.mts.map

package/src/logger.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.mts","sourceRoot":"","sources":["../../src/logger.mts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAErD;;;;OAIG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAEpD;;;;OAIG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAEpD;;;;OAIG;IACH,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAEnD;;;;OAIG;IACH,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;CACvD"}

package/src/logger.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=logger.mjs.map

package/src/logger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.mjs","sourceRoot":"","sources":["../../src/logger.mts"],"names":[],"mappings":""}

package/src/main.d.mts

@@ -0,0 +1,13 @@
+import type { Logger } from './logger.mjs';
+/** Options for Install Dependencies */
+export interface InstallDependenciesOptions {
+    /** Logger instance */
+    logger?: Logger;
+}
+/**
+ * Run the process to download and write dependency models
+ * @param workingDirectory
+ * @param options
+ */
+export declare const installDependencies: (workingDirectory?: string, options?: InstallDependenciesOptions) => Promise<void>;
+//# sourceMappingURL=main.d.mts.map

package/src/main.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.mts","sourceRoot":"","sources":["../../src/main.mts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EACV,MAAM,EACP,MAAM,cAAc,CAAC;AAEtB,uCAAuC;AACvC,MAAM,WAAW,0BAA0B;IACzC,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAU,yBAAwB,EAAE,UAAU,0BAA0B,KAAG,OAAO,CAAC,IAAI,CA2CtH,CAAC"}

package/src/main.mjs

@@ -0,0 +1,51 @@
+import { cwd, } from 'node:process';
+import { cleanOutputDirectory, } from './core/file-system/cleaner.mjs';
+import { writeModelFile, } from './core/file-system/write-model.mjs';
+import { extractDependencyModels, } from './core/manifest/extract-dependency-models.mjs';
+import { retrieveManifest, } from './core/manifest/manifest.mjs';
+import { deserialize, serialize, } from './core/serialization.mjs';
+import { addAnnotation, } from './core/transforms/add-annotation.mjs';
+import { applyMask, } from './core/transforms/apply-mask.mjs';
+import { renameTitle, } from './core/transforms/rename.mjs';
+import { toReference, } from './core/transforms/to-reference.mjs';
+import { updateReferences, } from './core/transforms/update-references.mjs';
+/**
+ * Run the process to download and write dependency models
+ * @param workingDirectory
+ * @param options
+ */
+export const installDependencies = async (workingDirectory = cwd(), options) => {
+    const { logger = console } = options || {};
+    const manifest = await retrieveManifest(workingDirectory, logger);
+    if (!manifest) {
+        logger?.info('No Manifest file discovered');
+        return;
+    }
+    await cleanOutputDirectory(workingDirectory);
+    const models = extractDependencyModels(workingDirectory, manifest, logger);
+    await cleanOutputDirectory(workingDirectory);
+    const results = await Promise.allSettled(models
+        .map(async (retrievedModelPromise) => {
+        const retrievedModel = await retrievedModelPromise;
+        logger?.debug?.(`Retrieving model from ${retrievedModel.artifactName} at ${retrievedModel.modelPath}`);
+        const modelObj = deserialize(retrievedModel.content, retrievedModel);
+        const transforms = [toReference, addAnnotation, applyMask, updateReferences, renameTitle];
+        transforms.reduce((acc, transform) => transform(acc, retrievedModel, logger), deserialize(retrievedModel.content, retrievedModel));
+        return {
+            ...retrievedModel,
+            content: serialize(modelObj, retrievedModel)
+        };
+    })
+        .map(async (processedModel) => {
+        await writeModelFile(await processedModel);
+    }));
+    const rejected = results
+        .filter((result) => result.status === 'rejected');
+    if (rejected.length > 0) {
+        logger?.error(`Failed to retrieve some models:`);
+        rejected.forEach((result) => logger?.error(result.reason));
+        throw new Error('Failed to retrieve some models');
+    }
+    logger?.info(`Successfully retrieved all models`);
+};
+//# sourceMappingURL=main.mjs.map

package/src/main.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.mjs","sourceRoot":"","sources":["../../src/main.mts"],"names":[],"mappings":"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"}

package/src/public_api.d.mts

@@ -0,0 +1,4 @@
+export * from './logger.mjs';
+export * from './constants.mjs';
+export * from './main.mjs';
+//# sourceMappingURL=public_api.d.mts.map

package/src/public_api.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public_api.d.mts","sourceRoot":"","sources":["../../src/public_api.mts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC"}

package/src/public_api.mjs

@@ -0,0 +1,4 @@
+export * from './logger.mjs';
+export * from './constants.mjs';
+export * from './main.mjs';
+//# sourceMappingURL=public_api.mjs.map

package/src/public_api.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"public_api.mjs","sourceRoot":"","sources":["../../src/public_api.mts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC"}