@acmekit/framework 2.13.1

package/dist/acmekit-app-loader.d.ts

@@ -0,0 +1,70 @@
+import { AcmeKitAppOutput, RegisterModuleJoinerConfig } from "@acmekit/modules-sdk";
+import { CommonTypes, ILinkMigrationsPlanner, InternalModuleDeclaration, LoadedModule, ModuleServiceInitializeOptions } from "@acmekit/types";
+import type { Knex } from "@acmekit/framework/mikro-orm/knex";
+import { AcmeKitContainer } from "./container";
+export declare class AcmeKitAppLoader {
+    #private;
+    constructor({ container, customLinksModules, acmekitConfigPath, cwd, }?: {
+        container?: AcmeKitContainer;
+        customLinksModules?: RegisterModuleJoinerConfig | RegisterModuleJoinerConfig[];
+        acmekitConfigPath?: string;
+        cwd?: string;
+    });
+    protected mergeDefaultModules(modulesConfig: CommonTypes.ConfigModule["modules"]): {
+        [x: string]: boolean | Partial<InternalModuleDeclaration | import("@acmekit/types").ExternalModuleDeclaration>;
+    };
+    protected prepareSharedResourcesAndDeps(): {
+        sharedResourcesConfig: ModuleServiceInitializeOptions;
+        injectedDependencies: {
+            __pg_connection__: Knex<any, any[]>;
+            logger: import("@acmekit/types").Logger;
+        };
+    };
+    /**
+     * Run, Revert or Generate the migrations for the acmekit app.
+     *
+     * @param moduleNames
+     * @param linkModules
+     * @param action
+     */
+    runModulesMigrations(options?: {
+        action: "run";
+        allOrNothing?: boolean;
+    } | {
+        action: "revert" | "generate";
+        moduleNames: string[];
+        allOrNothing?: never;
+    }): Promise<void>;
+    /**
+     * Return an instance of the link module migration planner.
+     */
+    getLinksExecutionPlanner(): Promise<ILinkMigrationsPlanner>;
+    /**
+     * Run the modules loader without taking care of anything else. This is useful for running the loader as a separate action or to re run all modules loaders.
+     */
+    runModulesLoader(): Promise<void>;
+    /**
+     * Reload a single module by its key
+     * @param moduleKey - The key of the module to reload (e.g., 'contactUsModuleService')
+     */
+    reloadSingleModule({ moduleKey, serviceName, }: {
+        /**
+         * the key of the module to reload in the acmekit config (either infered or specified)
+         */
+        moduleKey: string;
+        /**
+         * Registration name of the service to reload in the container
+         */
+        serviceName: string;
+    }): Promise<LoadedModule | null>;
+    /**
+     * Load all modules and bootstrap all the modules and links to be ready to be consumed
+     * @param config
+     */
+    load(config?: {
+        registerInContainer?: boolean;
+        schemaOnly?: boolean;
+        migrationOnly?: boolean;
+    }): Promise<AcmeKitAppOutput>;
+}
+//# sourceMappingURL=acmekit-app-loader.d.ts.map

package/dist/acmekit-app-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acmekit-app-loader.d.ts","sourceRoot":"","sources":["../src/acmekit-app-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,gBAAgB,EAGhB,0BAA0B,EAC3B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,WAAW,EAEX,sBAAsB,EAEtB,yBAAyB,EACzB,YAAY,EAEZ,8BAA8B,EAC/B,MAAM,gBAAgB,CAAA;AASvB,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mCAAmC,CAAA;AAG7D,OAAO,EAGL,gBAAgB,EACjB,MAAM,aAAa,CAAA;AAEpB,qBAAa,gBAAgB;;gBAqBf,EACV,SAAS,EACT,kBAAkB,EAClB,iBAAiB,EACjB,GAAG,GACJ,GAAE;QACD,SAAS,CAAC,EAAE,gBAAgB,CAAA;QAC5B,kBAAkB,CAAC,EACf,0BAA0B,GAC1B,0BAA0B,EAAE,CAAA;QAChC,iBAAiB,CAAC,EAAE,MAAM,CAAA;QAC1B,GAAG,CAAC,EAAE,MAAM,CAAA;KACR;IAON,SAAS,CAAC,mBAAmB,CAC3B,aAAa,EAAE,WAAW,CAAC,YAAY,CAAC,SAAS,CAAC;;;IAuCpD,SAAS,CAAC,6BAA6B;;;;;;;IAiCvC;;;;;;OAMG;IACG,oBAAoB,CACxB,OAAO,GACH;QACE,MAAM,EAAE,KAAK,CAAA;QACb,YAAY,CAAC,EAAE,OAAO,CAAA;KACvB,GACD;QACE,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAA;QAC7B,WAAW,EAAE,MAAM,EAAE,CAAA;QACrB,YAAY,CAAC,EAAE,KAAK,CAAA;KAGzB,GACA,OAAO,CAAC,IAAI,CAAC;IA0BhB;;OAEG;IACG,wBAAwB,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAkBjE;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBvC;;;OAGG;IACG,kBAAkB,CAAC,EACvB,SAAS,EACT,WAAW,GACZ,EAAE;QACD;;WAEG;QACH,SAAS,EAAE,MAAM,CAAA;QACjB;;WAEG;QACH,WAAW,EAAE,MAAM,CAAA;KACpB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAsDhC;;;OAGG;IACG,IAAI,CACR,MAAM,GAAE;QACN,mBAAmB,CAAC,EAAE,OAAO,CAAA;QAC7B,UAAU,CAAC,EAAE,OAAO,CAAA;QACpB,aAAa,CAAC,EAAE,OAAO,CAAA;KAKxB,GACA,OAAO,CAAC,gBAAgB,CAAC;CA2E7B"}

package/dist/acmekit-app-loader.js

@@ -0,0 +1,256 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _AcmeKitAppLoader_container, _AcmeKitAppLoader_customLinksModules, _AcmeKitAppLoader_acmekitConfigPath, _AcmeKitAppLoader_cwd;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AcmeKitAppLoader = void 0;
+const modules_sdk_1 = require("@acmekit/modules-sdk");
+const utils_1 = require("@acmekit/utils");
+const awilix_1 = require("./deps/awilix");
+const config_1 = require("./config");
+const container_1 = require("./container");
+class AcmeKitAppLoader {
+    // TODO: Adjust all loaders to accept an optional container such that in test env it is possible if needed to provide a specific container otherwise use the main container
+    // Maybe also adjust the different places to resolve the config from the container instead of the configManager for the same reason
+    // To be discussed
+    constructor({ container, customLinksModules, acmekitConfigPath, cwd, } = {}) {
+        /**
+         * Container from where to resolve resources
+         * @private
+         */
+        _AcmeKitAppLoader_container.set(this, void 0);
+        /**
+         * Extra links modules config which should be added manually to the links to be loaded
+         * @private
+         */
+        _AcmeKitAppLoader_customLinksModules.set(this, void 0);
+        _AcmeKitAppLoader_acmekitConfigPath.set(this, void 0);
+        _AcmeKitAppLoader_cwd.set(this, void 0);
+        __classPrivateFieldSet(this, _AcmeKitAppLoader_container, container ?? container_1.container, "f");
+        __classPrivateFieldSet(this, _AcmeKitAppLoader_customLinksModules, customLinksModules ?? [], "f");
+        __classPrivateFieldSet(this, _AcmeKitAppLoader_acmekitConfigPath, acmekitConfigPath, "f");
+        __classPrivateFieldSet(this, _AcmeKitAppLoader_cwd, cwd, "f");
+    }
+    mergeDefaultModules(modulesConfig) {
+        const defaultModules = Object.values(modules_sdk_1.ModulesDefinition).filter((definition) => {
+            return !!definition.defaultPackage;
+        });
+        const configModules = { ...modulesConfig };
+        for (const defaultModule of defaultModules) {
+            configModules[defaultModule.key] ??=
+                defaultModule.defaultModuleDeclaration;
+        }
+        for (const [key, value] of Object.entries(configModules)) {
+            const def = {};
+            def.key ??= key;
+            def.label ??= modules_sdk_1.ModulesDefinition[key]?.label ?? (0, utils_1.upperCaseFirst)(key);
+            def.dependencies ??= modules_sdk_1.ModulesDefinition[key]?.dependencies;
+            def.isQueryable = modules_sdk_1.ModulesDefinition[key]?.isQueryable ?? true;
+            const orignalDef = value?.definition ?? modules_sdk_1.ModulesDefinition[key];
+            if (!(0, utils_1.isBoolean)(value) &&
+                ((0, utils_1.isObject)(orignalDef) || !(0, utils_1.isPresent)(value.definition))) {
+                value.definition = {
+                    ...def,
+                    ...orignalDef,
+                };
+            }
+        }
+        return configModules;
+    }
+    prepareSharedResourcesAndDeps() {
+        const injectedDependencies = {
+            [utils_1.ContainerRegistrationKeys.PG_CONNECTION]: __classPrivateFieldGet(this, _AcmeKitAppLoader_container, "f").resolve(utils_1.ContainerRegistrationKeys.PG_CONNECTION),
+            [utils_1.ContainerRegistrationKeys.LOGGER]: __classPrivateFieldGet(this, _AcmeKitAppLoader_container, "f").resolve(utils_1.ContainerRegistrationKeys.LOGGER),
+        };
+        const driverOptions = {
+            ...(config_1.configManager.config.projectConfig.databaseDriverOptions ?? {}),
+        };
+        const pool = driverOptions.pool ?? {};
+        delete driverOptions.pool;
+        const sharedResourcesConfig = {
+            database: {
+                clientUrl: injectedDependencies[utils_1.ContainerRegistrationKeys.PG_CONNECTION]?.client
+                    ?.config?.connection?.connectionString ??
+                    config_1.configManager.config.projectConfig.databaseUrl,
+                driverOptions: config_1.configManager.config.projectConfig.databaseDriverOptions,
+                pool: pool,
+                debug: config_1.configManager.config.projectConfig.databaseLogging ?? false,
+                schema: config_1.configManager.config.projectConfig.databaseSchema,
+                database: config_1.configManager.config.projectConfig.databaseName,
+            },
+        };
+        return { sharedResourcesConfig, injectedDependencies };
+    }
+    /**
+     * Run, Revert or Generate the migrations for the acmekit app.
+     *
+     * @param moduleNames
+     * @param linkModules
+     * @param action
+     */
+    async runModulesMigrations(options = {
+        action: "run",
+    }) {
+        const configModules = this.mergeDefaultModules(config_1.configManager.config.modules);
+        const { sharedResourcesConfig, injectedDependencies } = this.prepareSharedResourcesAndDeps();
+        const migrationOptions = {
+            modulesConfig: configModules,
+            sharedContainer: __classPrivateFieldGet(this, _AcmeKitAppLoader_container, "f"),
+            linkModules: __classPrivateFieldGet(this, _AcmeKitAppLoader_customLinksModules, "f"),
+            sharedResourcesConfig,
+            injectedDependencies,
+            acmekitConfigPath: __classPrivateFieldGet(this, _AcmeKitAppLoader_acmekitConfigPath, "f"),
+            cwd: __classPrivateFieldGet(this, _AcmeKitAppLoader_cwd, "f"),
+            allOrNothing: options.allOrNothing,
+        };
+        if (options.action === "revert") {
+            await (0, modules_sdk_1.AcmeKitAppMigrateDown)(options.moduleNames, migrationOptions);
+        }
+        else if (options.action === "run") {
+            await (0, modules_sdk_1.AcmeKitAppMigrateUp)(migrationOptions);
+        }
+        else if (options.action === "generate") {
+            await (0, modules_sdk_1.AcmeKitAppMigrateGenerate)(options.moduleNames, migrationOptions);
+        }
+    }
+    /**
+     * Return an instance of the link module migration planner.
+     */
+    async getLinksExecutionPlanner() {
+        const configModules = this.mergeDefaultModules(config_1.configManager.config.modules);
+        const { sharedResourcesConfig, injectedDependencies } = this.prepareSharedResourcesAndDeps();
+        const migrationOptions = {
+            modulesConfig: configModules,
+            sharedContainer: __classPrivateFieldGet(this, _AcmeKitAppLoader_container, "f"),
+            linkModules: __classPrivateFieldGet(this, _AcmeKitAppLoader_customLinksModules, "f"),
+            sharedResourcesConfig,
+            injectedDependencies,
+            acmekitConfigPath: __classPrivateFieldGet(this, _AcmeKitAppLoader_acmekitConfigPath, "f"),
+            cwd: __classPrivateFieldGet(this, _AcmeKitAppLoader_cwd, "f"),
+        };
+        return await (0, modules_sdk_1.AcmeKitAppGetLinksExecutionPlanner)(migrationOptions);
+    }
+    /**
+     * Run the modules loader without taking care of anything else. This is useful for running the loader as a separate action or to re run all modules loaders.
+     */
+    async runModulesLoader() {
+        const { sharedResourcesConfig, injectedDependencies } = this.prepareSharedResourcesAndDeps();
+        const configModules = this.mergeDefaultModules(config_1.configManager.config.modules);
+        await (0, modules_sdk_1.AcmeKitApp)({
+            modulesConfig: configModules,
+            sharedContainer: __classPrivateFieldGet(this, _AcmeKitAppLoader_container, "f"),
+            linkModules: __classPrivateFieldGet(this, _AcmeKitAppLoader_customLinksModules, "f"),
+            sharedResourcesConfig,
+            injectedDependencies,
+            loaderOnly: true,
+            acmekitConfigPath: __classPrivateFieldGet(this, _AcmeKitAppLoader_acmekitConfigPath, "f"),
+            cwd: __classPrivateFieldGet(this, _AcmeKitAppLoader_cwd, "f"),
+        });
+    }
+    /**
+     * Reload a single module by its key
+     * @param moduleKey - The key of the module to reload (e.g., 'contactUsModuleService')
+     */
+    async reloadSingleModule({ moduleKey, serviceName, }) {
+        const configModule = __classPrivateFieldGet(this, _AcmeKitAppLoader_container, "f").resolve(utils_1.ContainerRegistrationKeys.CONFIG_MODULE);
+        modules_sdk_1.AcmeKitModule.unregisterModuleResolution(moduleKey);
+        if (serviceName) {
+            __classPrivateFieldGet(this, _AcmeKitAppLoader_container, "f").cache.delete(serviceName);
+        }
+        const moduleConfig = configModule.modules?.[moduleKey];
+        if (!moduleConfig) {
+            return null;
+        }
+        const { sharedResourcesConfig, injectedDependencies } = this.prepareSharedResourcesAndDeps();
+        const mergedModules = this.mergeDefaultModules({
+            [moduleKey]: moduleConfig,
+        });
+        const moduleDefinition = mergedModules[moduleKey];
+        const result = await (0, modules_sdk_1.AcmeKitApp)({
+            modulesConfig: { [moduleKey]: moduleDefinition },
+            sharedContainer: __classPrivateFieldGet(this, _AcmeKitAppLoader_container, "f"),
+            linkModules: __classPrivateFieldGet(this, _AcmeKitAppLoader_customLinksModules, "f"),
+            sharedResourcesConfig,
+            injectedDependencies,
+            workerMode: configModule.projectConfig?.workerMode,
+            acmekitConfigPath: __classPrivateFieldGet(this, _AcmeKitAppLoader_acmekitConfigPath, "f"),
+            cwd: __classPrivateFieldGet(this, _AcmeKitAppLoader_cwd, "f"),
+        });
+        const loadedModule = result.modules[moduleKey];
+        if (loadedModule) {
+            __classPrivateFieldGet(this, _AcmeKitAppLoader_container, "f").register({
+                [loadedModule.__definition.key]: (0, awilix_1.asValue)(loadedModule),
+            });
+        }
+        if (loadedModule?.__hooks?.onApplicationStart) {
+            await loadedModule.__hooks.onApplicationStart
+                .bind(loadedModule)()
+                .catch((error) => {
+                injectedDependencies[utils_1.ContainerRegistrationKeys.LOGGER].error(`Error starting module "${loadedModule.__definition.key}": ${error.message}`);
+            });
+        }
+        return loadedModule;
+    }
+    /**
+     * Load all modules and bootstrap all the modules and links to be ready to be consumed
+     * @param config
+     */
+    async load(config = {
+        registerInContainer: true,
+        schemaOnly: false,
+        migrationOnly: false,
+    }) {
+        const configModule = __classPrivateFieldGet(this, _AcmeKitAppLoader_container, "f").resolve(utils_1.ContainerRegistrationKeys.CONFIG_MODULE);
+        const { sharedResourcesConfig, injectedDependencies } = !config.migrationOnly && !config.schemaOnly
+            ? this.prepareSharedResourcesAndDeps()
+            : {};
+        __classPrivateFieldGet(this, _AcmeKitAppLoader_container, "f").register(utils_1.ContainerRegistrationKeys.REMOTE_QUERY, (0, awilix_1.asValue)(undefined));
+        __classPrivateFieldGet(this, _AcmeKitAppLoader_container, "f").register(utils_1.ContainerRegistrationKeys.QUERY, (0, awilix_1.asValue)(undefined));
+        __classPrivateFieldGet(this, _AcmeKitAppLoader_container, "f").register(utils_1.ContainerRegistrationKeys.LINK, (0, awilix_1.asValue)(undefined));
+        __classPrivateFieldGet(this, _AcmeKitAppLoader_container, "f").register(utils_1.ContainerRegistrationKeys.REMOTE_LINK, (0, awilix_1.aliasTo)(utils_1.ContainerRegistrationKeys.LINK));
+        const configModules = this.mergeDefaultModules(configModule.modules);
+        const acmekitApp = await (0, modules_sdk_1.AcmeKitApp)({
+            workerMode: configModule.projectConfig.workerMode,
+            modulesConfig: configModules,
+            sharedContainer: __classPrivateFieldGet(this, _AcmeKitAppLoader_container, "f"),
+            linkModules: __classPrivateFieldGet(this, _AcmeKitAppLoader_customLinksModules, "f"),
+            sharedResourcesConfig,
+            injectedDependencies,
+            acmekitConfigPath: __classPrivateFieldGet(this, _AcmeKitAppLoader_acmekitConfigPath, "f"),
+            cwd: __classPrivateFieldGet(this, _AcmeKitAppLoader_cwd, "f"),
+            migrationOnly: config.migrationOnly,
+            schemaOnly: config.schemaOnly,
+        });
+        if (!config.registerInContainer) {
+            return acmekitApp;
+        }
+        __classPrivateFieldGet(this, _AcmeKitAppLoader_container, "f").register(utils_1.ContainerRegistrationKeys.LINK, (0, awilix_1.asValue)(acmekitApp.link));
+        __classPrivateFieldGet(this, _AcmeKitAppLoader_container, "f").register(utils_1.ContainerRegistrationKeys.REMOTE_LINK, (0, awilix_1.aliasTo)(utils_1.ContainerRegistrationKeys.LINK));
+        __classPrivateFieldGet(this, _AcmeKitAppLoader_container, "f").register(utils_1.ContainerRegistrationKeys.REMOTE_QUERY, (0, awilix_1.asValue)(acmekitApp.query));
+        __classPrivateFieldGet(this, _AcmeKitAppLoader_container, "f").register(utils_1.ContainerRegistrationKeys.QUERY, (0, awilix_1.asValue)(acmekitApp.query));
+        for (const moduleService of Object.values(acmekitApp.modules)) {
+            const loadedModule = moduleService;
+            container_1.container.register(loadedModule.__definition.key, (0, awilix_1.asValue)(moduleService));
+        }
+        // Register all unresolved modules as undefined to be present in the container with undefined value by default
+        // but still resolvable
+        for (const moduleDefinition of Object.values(modules_sdk_1.ModulesDefinition)) {
+            if (!container_1.container.hasRegistration(moduleDefinition.key)) {
+                container_1.container.register(moduleDefinition.key, (0, awilix_1.asValue)(undefined));
+            }
+        }
+        return acmekitApp;
+    }
+}
+exports.AcmeKitAppLoader = AcmeKitAppLoader;
+_AcmeKitAppLoader_container = new WeakMap(), _AcmeKitAppLoader_customLinksModules = new WeakMap(), _AcmeKitAppLoader_acmekitConfigPath = new WeakMap(), _AcmeKitAppLoader_cwd = new WeakMap();
+//# sourceMappingURL=acmekit-app-loader.js.map

package/dist/acmekit-app-loader.js.map

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

package/dist/build-tools/compiler.d.ts

@@ -0,0 +1,64 @@
+import type { AdminOptions, Logger } from "@acmekit/types";
+import type tsStatic from "typescript";
+/**
+ * The compiler exposes the opinionated APIs for compiling AcmeKit
+ * applications and plugins. You can perform the following
+ * actions.
+ *
+ * - loadTSConfigFile: Load and parse the TypeScript config file. All errors
+ *   will be reported using the logger.
+ *
+ * - buildAppBackend: Compile the AcmeKit application backend source code to the
+ *   ".acmekit/server" directory. The admin source and integration-tests are
+ *   skipped.
+ *
+ * - buildAppFrontend: Compile the admin extensions using the "@medusjs/admin-bundler"
+ *   package. Admin can be compiled for self hosting (aka adminOnly), or can be compiled
+ *   to be bundled with the backend output.
+ */
+export declare class Compiler {
+    #private;
+    constructor(projectRoot: string, logger: Logger);
+    /**
+     * Loads and parses the TypeScript config file. In case of an error, the errors
+     * will be logged using the logger and undefined it returned
+     */
+    loadTSConfigFile(): Promise<tsStatic.ParsedCommandLine | undefined>;
+    /**
+     * Builds the application backend source code using
+     * TypeScript's official compiler. Also performs
+     * type-checking
+     */
+    buildAppBackend(tsConfig: tsStatic.ParsedCommandLine): Promise<boolean>;
+    /**
+     * Builds the frontend source code of a AcmeKit application
+     * using the "@acmekit/admin-bundler" package.
+     */
+    buildAppFrontend(adminOnly: boolean, tsConfig: tsStatic.ParsedCommandLine, adminBundler: {
+        build: (options: AdminOptions & {
+            sources: string[];
+            plugins: string[];
+            outDir: string;
+        }) => Promise<void>;
+    }): Promise<boolean>;
+    /**
+     * Compiles the plugin source code to JavaScript using the
+     * TypeScript's official compiler
+     */
+    buildPluginBackend(tsConfig: tsStatic.ParsedCommandLine): Promise<boolean>;
+    /**
+     * Compiles the backend source code of a plugin project in watch
+     * mode. Type-checking is disabled to keep compilation fast.
+     *
+     * The "onFileChange" argument can be used to get notified when
+     * a file has changed.
+     */
+    developPluginBackend(transformer: (filePath: string) => Promise<string>, onFileChange?: (filePath: string, action: "add" | "change" | "unlink") => void): Promise<void>;
+    buildPluginAdminExtensions(bundler: {
+        plugin: (options: {
+            root: string;
+            outDir: string;
+        }) => Promise<void>;
+    }): Promise<boolean>;
+}
+//# sourceMappingURL=compiler.d.ts.map

package/dist/build-tools/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../src/build-tools/compiler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAKxE,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAA;AAEtC;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,QAAQ;;gBASP,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IA2L/C;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,QAAQ,CAAC,iBAAiB,GAAG,SAAS,CAAC;IA2CzE;;;;OAIG;IACG,eAAe,CACnB,QAAQ,EAAE,QAAQ,CAAC,iBAAiB,GACnC,OAAO,CAAC,OAAO,CAAC;IAwDnB;;;OAGG;IACG,gBAAgB,CACpB,SAAS,EAAE,OAAO,EAClB,QAAQ,EAAE,QAAQ,CAAC,iBAAiB,EACpC,YAAY,EAAE;QACZ,KAAK,EAAE,CACL,OAAO,EAAE,YAAY,GAAG;YACtB,OAAO,EAAE,MAAM,EAAE,CAAA;YACjB,OAAO,EAAE,MAAM,EAAE,CAAA;YACjB,MAAM,EAAE,MAAM,CAAA;SACf,KACE,OAAO,CAAC,IAAI,CAAC,CAAA;KACnB,GACA,OAAO,CAAC,OAAO,CAAC;IA0EnB;;;OAGG;IACG,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,iBAAiB;IA8C7D;;;;;;OAMG;IACG,oBAAoB,CACxB,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EAClD,YAAY,CAAC,EAAE,CACb,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,KAChC,IAAI;IA8DL,0BAA0B,CAAC,OAAO,EAAE;QACxC,MAAM,EAAE,CAAC,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KACrE;CAkBF"}