@webda/compiler 4.0.0-beta.3

package/LICENSE

@@ -0,0 +1,166 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.
+

package/README.md

@@ -0,0 +1,125 @@
+# @webda/compiler module
+
+This module is part of Webda Application Framework that allows you to quickly develop applications with all modern prerequisites: Security, Extensibility, GraphQL, REST, CloudNative [https://webda.io](https://webda.io)
+
+<img src="https://webda.io/images/webda.svg" width="128" />
+
+![CI](https://github.com/loopingz/webda.io/workflows/CI/badge.svg)
+
+[![Join the chat at https://gitter.im/loopingz/webda](https://badges.gitter.im/loopingz/webda.svg)](https://gitter.im/loopingz/webda?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+[![codecov](https://codecov.io/gh/loopingz/webda.io/branch/main/graph/badge.svg?token=8N9DNM3K3O)](https://codecov.io/gh/loopingz/webda.io)
+[![SonarCloud.io](https://sonarcloud.io/api/project_badges/measure?project=loopingz_webda.io&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=loopingz_webda.io)
+![CodeQL](https://github.com/loopingz/webda.io/workflows/CodeQL/badge.svg)
+
+<!-- README_HEADER -->
+
+## @webda/compiler
+
+The build toolchain for Webda applications. It compiles on TypeScript 7.1 through `@webda/content-mapper`, generates the module manifest (`webda.module.json`) and JSON Schemas for all models and service parameters, and can migrate sources written for older Webda versions.
+
+### When to use it
+
+- Run `webdac build` once after making changes to build and generate the module manifest.
+- Use `webdac build --watch` during development to rebuild on every change.
+- Use `webdac code` once when migrating an application from an older Webda version (moved imports, obsolete filter registrations).
+
+### Install
+
+```bash
+npm install --save-dev @webda/compiler
+```
+
+The `webdac` binary is included.
+
+### Commands
+
+#### `webdac build`
+
+Compiles the application TypeScript and regenerates `webda.module.json` and all schemas.
+
+```bash
+webdac build              # one-shot build
+webdac build --watch      # watch mode: rebuild on every change under src/
+webdac build --appPath /path/to/app
+```
+
+What it does:
+1. Compiles with TypeScript 7.1 through `@webda/content-mapper`, which generates accessors,
+   `toJSON` and behaviours, type-checks the result and emits ES modules to `lib/`
+2. Discovers models, services, deployers, and beans with the same type checker
+3. Generates per-model JSON Schemas (input, output, stored)
+4. Writes `webda.module.json` at the project root
+5. Merges dependency modules from `node_modules`
+6. Writes `.webda-config-schema.json` and `.webda-deployment-schema.json`
+
+#### `webdac code`
+
+Migrates application sources written for an older Webda version, in place:
+
+```bash
+webdac code                        # run every migration module
+webdac code --module updateImports # run a specific module
+```
+
+Migration modules available:
+
+| Module | Description |
+|--------|-------------|
+| `updateImports` | Moves imports to the packages that now own them |
+| `capabilities` | Removes filter registrations the framework now does automatically |
+
+It no longer generates code: `webdac build` does, without touching your sources.
+
+### `webda.module.json` format
+
+```json
+{
+  "$schema": "https://webda.io/schemas/webda.module.v4.json",
+  "beans": {
+    "MyApp/MyBean": {
+      "Import": "lib/services/mybean:MyBean",
+      "Schema": { ... }
+    }
+  },
+  "moddas": {
+    "MyApp/MyService": {
+      "Import": "lib/services/myservice:MyService",
+      "Schema": { ... }
+    }
+  },
+  "models": {
+    "MyApp/Post": {
+      "Import": "lib/models/post:Post",
+      "Schema": { ... }
+    }
+  },
+  "deployers": {},
+  "schemas": {}
+}
+```
+
+### See also
+
+- [Build reference](../../docs/pages/Modules/compiler/Build.md)
+- [Code generation](../../docs/pages/Modules/compiler/CodeGen.md)
+- [Module manifest](../../docs/pages/Modules/compiler/ModuleManifest.md)
+- [Extending the compiler](../../docs/pages/Modules/compiler/Plugins.md)
+
+<!-- README_FOOTER -->
+## Sponsors
+
+<!--
+Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor](mailto:sponsor@webda.io)
+-->
+
+Arize AI is a machine learning observability and model monitoring platform. It helps you visualize, monitor, and explain your machine learning models. [Learn more](https://arize.com)
+
+[<img src="https://arize.com/hubfs/arize/brand/arize-logomark-1.png" width="200">](https://arize.com)
+
+Loopingz is a software development company that provides consulting and development services. [Learn more](https://loopingz.com)
+
+[<img src="https://loopingz.com/images/logo.png" width="200">](https://loopingz.com)
+
+Tellae is an innovative consulting firm specialized in cities transportation issues. We provide our clients, both public and private, with solutions to support your strategic and operational decisions. [Learn more](https://tellae.fr)
+
+[<img src="https://tellae.fr/" width="200">](https://tellae.fr)

package/lib/compiler.d.ts

@@ -0,0 +1,88 @@
+import type { WebdaProject } from "./definition.js";
+/**
+ * Compiler
+ *
+ * Builds an application on TypeScript 7.1 through `@webda/content-mapper`:
+ * the two-pass build emits the JavaScript — generated accessors, behaviours
+ * and WebdaQL rewrites included, type-checked as written — and the same
+ * process generates `webda.module.json`. See `schema-backend.ts` for why it
+ * runs out of process, and `docs/contribute/TypeScript 7 Content Mappers.md`
+ * for the migration.
+ */
+export declare class Compiler {
+    project: WebdaProject;
+    /**
+     * If true the compiler has compiled already
+     */
+    compiled: boolean;
+    /** File watcher when in watch mode. */
+    private watcher?;
+    /** Pending rebuild in watch mode, debounced. */
+    private rebuild?;
+    /**
+     * True while rebuilding because `.webda/module.d.ts` changed
+     */
+    private secondPass;
+    /**
+     * Read the generated TypeScript library, if any
+     * @param file - path to `.webda/module.d.ts`
+     * @returns its content, or undefined when it does not exist
+     */
+    private readLibrary;
+    /**
+     * Create a new compiler for the given project
+     * @param project - the Webda project to compile
+     */
+    constructor(project: WebdaProject);
+    /**
+     * MD5 hex digest of a file's contents.
+     * @param path - absolute path to the file
+     * @returns the digest, or undefined if the file is missing
+     */
+    private fileDigest;
+    /**
+     * Add a system to recompile if needed
+     * @returns true if compilation is needed
+     */
+    requireCompilation(): boolean;
+    /**
+     * Whether an emitted file the module points at is missing.
+     *
+     * Every `Import` in `webda.module.json` names an emitted file
+     * (`lib/services/audit.model:AuditService`), so checking them follows the
+     * configured `outDir` and catches a partially deleted output. A module that
+     * declares nothing falls back to `lib/` existing.
+     * @param mod - the parsed `webda.module.json`
+     * @returns true if at least one output is missing
+     */
+    private missingOutputs;
+    /**
+     * This is our main entry point
+     * @param force - skip cache and force recompilation
+     * @returns true if compilation succeeded
+     */
+    compile(force?: boolean): boolean;
+    /**
+     * Persist the build cache: source digest plus the generated module file's
+     * content hash, so {@link requireCompilation} can detect both source-file
+     * changes and external mutations of webda.module.json.
+     */
+    private updateCache;
+    /**
+     * Launch compiler in watch mode
+     *
+     * Rebuilds on any change under `src/`, debounced. The TypeScript 6 version
+     * drove a `createWatchProgram`; there is no incremental emit with generated
+     * code in 7.1's API, and a full two-pass build is fast enough — well under
+     * a second for `@webda/core` — that a resident incremental program is not
+     * worth its complexity yet.
+     * @param callback - called with `MODULE_GENERATION` / `MODULE_GENERATED`
+     *   around each rebuild, and with `COMPILATION_ERROR` when one fails
+     */
+    watch(callback?: (event: string) => void): void;
+    /**
+     * Stop watching for changes
+     */
+    stopWatch(): void;
+}
+//# sourceMappingURL=compiler.d.ts.map

package/lib/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAIpD;;;;;;;;;GASG;AACH,qBAAa,QAAQ;IA2BA,OAAO,EAAE,YAAY;IA1BxC;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB,uCAAuC;IACvC,OAAO,CAAC,OAAO,CAAC,CAAY;IAC5B,gDAAgD;IAChD,OAAO,CAAC,OAAO,CAAC,CAAiB;IACjC;;OAEG;IACH,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAInB;;;OAGG;IACH,YAAmB,OAAO,EAAE,YAAY,EAAI;IAE5C;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAOlB;;;OAGG;IACH,kBAAkB,IAAI,OAAO,CAsC5B;IAED;;;;;;;;;OASG;IACH,OAAO,CAAC,cAAc;IAetB;;;;OAIG;IACH,OAAO,CAAC,KAAK,GAAE,OAAe,GAAG,OAAO,CA0DvC;IAED;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAWnB;;;;;;;;;;OAUG;IACH,KAAK,CAAC,QAAQ,GAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAe,QAWjD;IAED;;OAEG;IACH,SAAS,SAKR;CACF"}

package/lib/compiler.js

@@ -0,0 +1,230 @@
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, watch as watchFiles } from "node:fs";
+import { FileUtils } from "@webda/utils";
+import { useLog } from "@webda/workout";
+import { writeModule } from "./module.js";
+import { build } from "./schema-backend.js";
+/**
+ * Compiler
+ *
+ * Builds an application on TypeScript 7.1 through `@webda/content-mapper`:
+ * the two-pass build emits the JavaScript — generated accessors, behaviours
+ * and WebdaQL rewrites included, type-checked as written — and the same
+ * process generates `webda.module.json`. See `schema-backend.ts` for why it
+ * runs out of process, and `docs/contribute/TypeScript 7 Content Mappers.md`
+ * for the migration.
+ */
+export class Compiler {
+    project;
+    /**
+     * If true the compiler has compiled already
+     */
+    compiled;
+    /** File watcher when in watch mode. */
+    watcher;
+    /** Pending rebuild in watch mode, debounced. */
+    rebuild;
+    /**
+     * True while rebuilding because `.webda/module.d.ts` changed
+     */
+    secondPass = false;
+    /**
+     * Read the generated TypeScript library, if any
+     * @param file - path to `.webda/module.d.ts`
+     * @returns its content, or undefined when it does not exist
+     */
+    readLibrary(file) {
+        return existsSync(file) ? readFileSync(file, "utf8") : undefined;
+    }
+    /**
+     * Create a new compiler for the given project
+     * @param project - the Webda project to compile
+     */
+    constructor(project) {
+        this.project = project;
+    }
+    /**
+     * MD5 hex digest of a file's contents.
+     * @param path - absolute path to the file
+     * @returns the digest, or undefined if the file is missing
+     */
+    fileDigest(path) {
+        if (!existsSync(path)) {
+            return undefined;
+        }
+        return createHash("md5").update(readFileSync(path)).digest("hex");
+    }
+    /**
+     * Add a system to recompile if needed
+     * @returns true if compilation is needed
+     */
+    requireCompilation() {
+        const f = this.project.getAppPath(".webda/cache");
+        if (!existsSync(this.project.getAppPath(".webda"))) {
+            mkdirSync(this.project.getAppPath(".webda"));
+        }
+        if (!existsSync(f)) {
+            return true;
+        }
+        const webdaCache = FileUtils.load(f, "json");
+        const currentDigest = this.project.getDigest();
+        if (webdaCache.sourceDigest !== currentDigest) {
+            return true;
+        }
+        // Cross-check the on-disk webda.module.json: sources may be unchanged but
+        // the generated module file can drift from the cache (git checkout, manual
+        // edit, framework upgrade that regenerates it).
+        const modulePath = this.project.getAppPath("webda.module.json");
+        const moduleDigest = this.fileDigest(modulePath);
+        if (!moduleDigest || moduleDigest !== webdaCache.moduleDigest) {
+            return true;
+        }
+        let moduleContent;
+        try {
+            moduleContent = FileUtils.load(modulePath, "json");
+        }
+        catch {
+            return true;
+        }
+        // The output has to exist too. The digests only describe the inputs, so
+        // without this a deleted `lib/` — or a single deleted file in it — was
+        // reported as up to date.
+        if (this.missingOutputs(moduleContent)) {
+            return true;
+        }
+        useLog("DEBUG", "Skipping compilation as nothing changed");
+        return false;
+    }
+    /**
+     * Whether an emitted file the module points at is missing.
+     *
+     * Every `Import` in `webda.module.json` names an emitted file
+     * (`lib/services/audit.model:AuditService`), so checking them follows the
+     * configured `outDir` and catches a partially deleted output. A module that
+     * declares nothing falls back to `lib/` existing.
+     * @param mod - the parsed `webda.module.json`
+     * @returns true if at least one output is missing
+     */
+    missingOutputs(mod) {
+        const files = new Set();
+        for (const section of ["beans", "deployers", "moddas", "models", "behaviors"]) {
+            for (const entry of Object.values(mod[section] ?? {})) {
+                if (typeof entry?.Import === "string") {
+                    files.add(entry.Import.split(":")[0]);
+                }
+            }
+        }
+        if (files.size === 0) {
+            return !existsSync(this.project.getAppPath("lib"));
+        }
+        return [...files].some(file => !existsSync(this.project.getAppPath(`${file}.js`)));
+    }
+    /**
+     * This is our main entry point
+     * @param force - skip cache and force recompilation
+     * @returns true if compilation succeeded
+     */
+    compile(force = false) {
+        if ((this.compiled || !this.requireCompilation()) && !force) {
+            return true;
+        }
+        this.project.emit("compiling");
+        const started = Date.now();
+        const library = this.project.getAppPath(".webda/module.d.ts");
+        const libraryBefore = this.readLibrary(library);
+        let result;
+        try {
+            result = build(this.project.getAppPath(), {
+                namespace: this.project.namespace,
+                capabilities: this.project.packageDescription.webda?.capabilities
+            });
+        }
+        catch (err) {
+            useLog("ERROR", err.message);
+            this.project.emit("compilationError");
+            return false;
+        }
+        if (result.emit.diagnosticCount) {
+            result.emit.diagnostics
+                .split("\n")
+                .filter(line => line.trim() !== "")
+                .forEach(line => this.project.log("WARN", line));
+            this.project.emit("compilationError");
+            return false;
+        }
+        const compilation = Date.now() - started;
+        const moduleStart = Date.now();
+        this.project.emit("analyzing");
+        // A module that cannot be written fails the build. Under TypeScript 6 the
+        // error was logged and the build still reported success, so a strict
+        // file-naming violation never actually stopped anything.
+        if (!result.module || !writeModule(this, result.module)) {
+            this.project.emit("compilationError");
+            return false;
+        }
+        useLog("INFO", `Took: Compilation - ${compilation}ms | Module generation - ${Date.now() - moduleStart}ms`);
+        // writeModule regenerates .webda/module.d.ts, which declares the configured
+        // services and beans in ServicesMap. The schemas just written were derived
+        // from the previous version, so when it changed (a clean checkout, a new
+        // service) build once more against the new one.
+        if (!this.secondPass && this.readLibrary(library) !== libraryBefore) {
+            useLog("INFO", "Service map changed; rebuilding the module against it");
+            this.secondPass = true;
+            try {
+                return this.compile(true);
+            }
+            finally {
+                this.secondPass = false;
+            }
+        }
+        this.compiled = true;
+        this.updateCache();
+        this.project.emit("done");
+        return true;
+    }
+    /**
+     * Persist the build cache: source digest plus the generated module file's
+     * content hash, so {@link requireCompilation} can detect both source-file
+     * changes and external mutations of webda.module.json.
+     */
+    updateCache() {
+        const f = this.project.getAppPath(".webda/cache");
+        const webdaCache = existsSync(f) ? FileUtils.load(f, "json") : {};
+        webdaCache.sourceDigest = this.project.getDigest();
+        webdaCache.moduleDigest = this.fileDigest(this.project.getAppPath("webda.module.json"));
+        FileUtils.save(webdaCache, f, "json");
+    }
+    /**
+     * Launch compiler in watch mode
+     *
+     * Rebuilds on any change under `src/`, debounced. The TypeScript 6 version
+     * drove a `createWatchProgram`; there is no incremental emit with generated
+     * code in 7.1's API, and a full two-pass build is fast enough — well under
+     * a second for `@webda/core` — that a resident incremental program is not
+     * worth its complexity yet.
+     * @param callback - called with `MODULE_GENERATION` / `MODULE_GENERATED`
+     *   around each rebuild, and with `COMPILATION_ERROR` when one fails
+     */
+    watch(callback = () => { }) {
+        const run = () => {
+            callback("MODULE_GENERATION");
+            const ok = this.compile(true);
+            callback(ok ? "MODULE_GENERATED" : "COMPILATION_ERROR");
+        };
+        this.watcher = watchFiles(this.project.getAppPath("src"), { recursive: true }, () => {
+            clearTimeout(this.rebuild);
+            this.rebuild = setTimeout(run, 150);
+        });
+        run();
+    }
+    /**
+     * Stop watching for changes
+     */
+    stopWatch() {
+        clearTimeout(this.rebuild);
+        this.watcher?.close();
+        this.watcher = undefined;
+        this.compiled = false;
+    }
+}
+//# sourceMappingURL=compiler.js.map

package/lib/compiler.js.map

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

package/lib/configuration.d.ts

@@ -0,0 +1,35 @@
+import { JSONSchema7 } from "json-schema";
+/**
+ * Interface for the application methods needed by configuration schema generation
+ */
+export interface ConfigSchemaApplication {
+    getModdas(): {
+        [key: string]: any;
+    };
+    getSchema(type: string): JSONSchema7;
+    getDeployers(): {
+        [key: string]: any;
+    };
+    getConfiguration(): {
+        services: {
+            [key: string]: any;
+        };
+    };
+    getModules(): {
+        beans?: {
+            [key: string]: any;
+        };
+    };
+    completeNamespace(name: string): string;
+}
+/**
+ * Generate the configuration and deployment schemas
+ *
+ * @param app to use for application metadata
+ * @param filename to save config schema to
+ * @param deploymentFilename to save deployment schema to
+ * @param full to keep all required
+ * @param configFile - optional config file path to update $schema reference
+ */
+export declare function generateConfigurationSchemas(app: ConfigSchemaApplication, filename?: string, deploymentFilename?: string, full?: boolean, configFile?: string): void;
+//# sourceMappingURL=configuration.d.ts.map

package/lib/configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../src/configuration.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,SAAS,IAAI;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAC;IACpC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IACrC,YAAY,IAAI;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAC;IACvC,gBAAgB,IAAI;QAAE,QAAQ,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;SAAE,CAAA;KAAE,CAAC;IACzD,UAAU,IAAI;QAAE,KAAK,CAAC,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;SAAE,CAAA;KAAE,CAAC;IACjD,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACzC;AAgBD;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,uBAAuB,EAC5B,QAAQ,GAAE,MAAoC,EAC9C,kBAAkB,GAAE,MAAwC,EAC5D,IAAI,GAAE,OAAe,EACrB,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI,CAmJN"}