powerlines 0.24.9 → 0.25.0

package/dist/lib/{chunk-Z74G7RN3.cjs → chunk-SFEEJZLK.cjs}

@@ -1,11 +1,12 @@
 'use strict';
 
-var chunk2NZADVP5_cjs = require('./chunk-2NZADVP5.cjs');
 var chunk4NHFXDTQ_cjs = require('./chunk-4NHFXDTQ.cjs');
-var chunkYMHOAMCU_cjs = require('./chunk-YMHOAMCU.cjs');
+var chunk2NZADVP5_cjs = require('./chunk-2NZADVP5.cjs');
+var chunkNLJR4WIX_cjs = require('./chunk-NLJR4WIX.cjs');
 var chunkB3EE3VHZ_cjs = require('./chunk-B3EE3VHZ.cjs');
-var chunk3MZQ4MQX_cjs = require('./chunk-3MZQ4MQX.cjs');
-var chunk7VJ42H2I_cjs = require('./chunk-7VJ42H2I.cjs');
+var chunkWBSA6OG6_cjs = require('./chunk-WBSA6OG6.cjs');
+var chunkHRRI4KOM_cjs = require('./chunk-HRRI4KOM.cjs');
+var chunkD6MI2V6R_cjs = require('./chunk-D6MI2V6R.cjs');
 var chunkGA3RXX4R_cjs = require('./chunk-GA3RXX4R.cjs');
 var chunkJA4HSQRN_cjs = require('./chunk-JA4HSQRN.cjs');
 var chunk3OCI4TH7_cjs = require('./chunk-3OCI4TH7.cjs');
@@ -16,6 +17,7 @@ var core = require('@babel/core');
 var console = require('@storm-software/config-tools/logger/console');
 var toArray = require('@stryke/convert/to-array');
 var copyFile = require('@stryke/fs/copy-file');
+var helpers = require('@stryke/fs/helpers');
 var install = require('@stryke/fs/install');
 var listFiles = require('@stryke/fs/list-files');
 var packageFns = require('@stryke/fs/package-fns');
@@ -177,8 +179,11 @@ function formatTypes(code) {
 chunkUSNT2KNT_cjs.__name(formatTypes, "formatTypes");
 async function emitTypes(context, files) {
   context.log(types.LogLevelLabel.TRACE, `Running the TypeScript compiler for ${files.length} generated runtime files.`);
-  context.program.addSourceFilesAtPaths(files);
-  const result = context.program.emitToMemory({
+  const program = chunkD6MI2V6R_cjs.createProgram(context, {
+    skipAddingFilesFromTsConfig: true
+  });
+  program.addSourceFilesAtPaths(files);
+  const result = program.emitToMemory({
     emitOnlyDtsFiles: true
   });
   let builtinModules = "";
@@ -269,9 +274,6 @@ async function resolveTsconfigChanges(context) {
   const tsconfigJson = await json.readJsonFile(tsconfigFilePath);
   tsconfigJson.compilerOptions ??= {};
   if (context.config.output.dts !== false) {
-    if (filePathFns.findFileExtension(context.dtsPath) !== "d.ts" && filePathFns.findFileExtension(context.dtsPath) !== "d.cts" && filePathFns.findFileExtension(context.dtsPath) !== "d.mts") {
-      context.config.output.dts = joinPaths.joinPaths(context.dtsPath, "powerlines.d.ts");
-    }
     const dtsRelativePath = joinPaths.joinPaths(filePathFns.relativePath(joinPaths.joinPaths(context.workspaceConfig.workspaceRoot, context.config.projectRoot), filePathFns.findFilePath(context.dtsPath)), filePathFns.findFileName(context.dtsPath));
     if (!tsconfigJson.include?.some((filePattern) => chunkGA3RXX4R_cjs.isIncludeMatchFound(filePattern, [
       context.dtsPath,
@@ -314,9 +316,7 @@ async function initializeTsconfig(context) {
   context.tsconfig.originalTsconfigJson = await json.readJsonFile(tsconfigFilePath);
   context.tsconfig.tsconfigJson = await resolveTsconfigChanges(context);
   context.log(types.LogLevelLabel.TRACE, "Writing updated TypeScript configuration (tsconfig.json) file to disk.");
-  await context.fs.writeFile(tsconfigFilePath, stormJson.StormJSON.stringify(context.tsconfig.tsconfigJson), {
-    mode: "fs"
-  });
+  await chunk2NZADVP5_cjs.writeFile(context.log, tsconfigFilePath, stormJson.StormJSON.stringify(context.tsconfig.tsconfigJson));
   context.tsconfig = chunkGA3RXX4R_cjs.getParsedTypeScriptConfig(context.workspaceConfig.workspaceRoot, context.config.projectRoot, context.config.tsconfig, context.config.tsconfigRaw, context.tsconfig.originalTsconfigJson);
 }
 chunkUSNT2KNT_cjs.__name(initializeTsconfig, "initializeTsconfig");
@@ -402,7 +402,7 @@ var PowerlinesAPI = class _PowerlinesAPI {
   * Initialize the Powerlines API
   */
   static async from(workspaceRoot, config) {
-    const api = new _PowerlinesAPI(await chunkYMHOAMCU_cjs.PowerlinesAPIContext.from(workspaceRoot, config));
+    const api = new _PowerlinesAPI(await chunkNLJR4WIX_cjs.PowerlinesAPIContext.from(workspaceRoot, config));
     api.#context.$$internal.api = api;
     for (const plugin of api.context.config.plugins ?? []) {
       await api.#addPlugin(plugin);
@@ -446,24 +446,20 @@ ${context.entry.map((entry) => `- ${entry.input.file || entry.file}${entry.outpu
       context.log(types.LogLevelLabel.TRACE, `Powerlines configuration has been resolved: 
 
 ${console.formatLogMessage(context.config)}`);
-      await chunk7VJ42H2I_cjs.writeMetaFile(context);
+      await chunkHRRI4KOM_cjs.writeMetaFile(context);
       context.persistedMeta = context.meta;
       if (!context.fs.existsSync(context.cachePath)) {
-        await context.fs.mkdir(context.cachePath, {
-          mode: "fs"
-        });
+        await helpers.createDirectory(context.cachePath);
       }
       if (!context.fs.existsSync(context.dataPath)) {
-        await context.fs.mkdir(context.dataPath, {
-          mode: "fs"
-        });
+        await helpers.createDirectory(context.dataPath);
       }
       await this.callPreHook(context, "prepare");
       await this.callNormalHook(context, "prepare");
       if (context.config.output.dts !== false) {
         context.log(types.LogLevelLabel.TRACE, `Preparing the TypeScript definitions for the Powerlines project.`);
         if (context.fs.existsSync(context.dtsPath)) {
-          await context.fs.unlink(context.dtsPath);
+          await context.fs.remove(context.dtsPath);
         }
         context.log(types.LogLevelLabel.TRACE, "Transforming built-ins runtime modules files.");
         const builtinFilePaths = await Promise.all((await context.getBuiltins()).map(async (file) => {
@@ -550,7 +546,7 @@ ${console.formatLogMessage(context.config)}`);
             generatedTypes = result;
           }
         }
-        await context.fs.writeFile(context.dtsPath, `${directives ? `${directives.map((directive) => `/// <reference types="${directive}" />`).join("\n")}
+        await context.fs.write(context.dtsPath, `${directives ? `${directives.map((directive) => `/// <reference types="${directive}" />`).join("\n")}
 
 ` : ""}${chunk4NHFXDTQ_cjs.getFileHeader(context, {
           directive: null,
@@ -558,16 +554,14 @@ ${console.formatLogMessage(context.config)}`);
         })}
 
 ${formatTypes(generatedTypes)}
-`, {
-          mode: "fs"
-        });
+`);
       }
       context.tsconfig = chunkGA3RXX4R_cjs.getParsedTypeScriptConfig(context.workspaceConfig.workspaceRoot, context.config.projectRoot, context.config.tsconfig);
       if (!context.tsconfig) {
         throw new Error("Failed to parse the TypeScript configuration file.");
       }
       await this.callPostHook(context, "prepare");
-      await chunk7VJ42H2I_cjs.writeMetaFile(context);
+      await chunkHRRI4KOM_cjs.writeMetaFile(context);
     });
     this.context.log(types.LogLevelLabel.INFO, "Powerlines API has been prepared successfully");
   }
@@ -628,8 +622,8 @@ ${formatTypes(generatedTypes)}
     await this.prepare(inlineConfig);
     await this.#executeEnvironments(async (context) => {
       this.context.log(types.LogLevelLabel.TRACE, "Cleaning the project's dist and artifacts directories.");
-      await context.fs.rmdir(joinPaths.joinPaths(context.workspaceConfig.workspaceRoot, context.config.output.distPath));
-      await context.fs.rmdir(joinPaths.joinPaths(context.workspaceConfig.workspaceRoot, context.config.output.artifactsFolder));
+      await context.fs.remove(joinPaths.joinPaths(context.workspaceConfig.workspaceRoot, context.config.output.buildPath));
+      await context.fs.remove(joinPaths.joinPaths(context.workspaceConfig.workspaceRoot, context.config.output.artifactsPath));
       await chunkB3EE3VHZ_cjs.callHook(context, "clean", {
         sequential: true
       });
@@ -671,11 +665,11 @@ ${formatTypes(generatedTypes)}
     await this.#executeEnvironments(async (context) => {
       await this.callPreHook(context, "build");
       await this.callNormalHook(context, "build");
-      if (context.config.output.distPath !== context.config.output.outputPath) {
-        const sourcePath = append.appendPath(context.config.output.distPath, context.workspaceConfig.workspaceRoot);
+      if (context.config.output.buildPath !== context.config.output.outputPath) {
+        const sourcePath = append.appendPath(context.config.output.buildPath, context.workspaceConfig.workspaceRoot);
         const destinationPath = joinPaths.joinPaths(append.appendPath(context.config.output.outputPath, context.workspaceConfig.workspaceRoot), "dist");
         if (sourcePath !== destinationPath) {
-          context.log(types.LogLevelLabel.INFO, `Copying build output files from project's build directory (${context.config.output.distPath}) to the workspace's output directory (${context.config.output.outputPath}).`);
+          context.log(types.LogLevelLabel.INFO, `Copying build output files from project's build directory (${context.config.output.buildPath}) to the workspace's output directory (${context.config.output.outputPath}).`);
           await copyFile.copyFiles({
             input: sourcePath,
             glob: "**/*"
@@ -904,11 +898,11 @@ ${formatTypes(generatedTypes)}
     if (isPromise.isPromiseLike(config)) {
       awaited = await Promise.resolve(config);
     }
-    if (!chunk3MZQ4MQX_cjs.isPluginConfig(awaited)) {
+    if (!chunkWBSA6OG6_cjs.isPluginConfig(awaited)) {
       throw new Error(`Invalid plugin specified in the configuration - ${JSON.stringify(awaited)}. Please ensure the value is a plugin name, an object with the \`plugin\` and \`props\` properties, or an instance of \`Plugin\`.`);
     }
     let plugin;
-    if (chunk3MZQ4MQX_cjs.isPlugin(awaited)) {
+    if (chunkWBSA6OG6_cjs.isPlugin(awaited)) {
       plugin = awaited;
     } else if (isFunction.isFunction(awaited)) {
       plugin = await Promise.resolve(awaited());
@@ -919,10 +913,10 @@ ${formatTypes(generatedTypes)}
       } else {
         plugin = resolved;
       }
-    } else if (chunk3MZQ4MQX_cjs.isPluginConfigTuple(awaited) || chunk3MZQ4MQX_cjs.isPluginConfigObject(awaited)) {
+    } else if (chunkWBSA6OG6_cjs.isPluginConfigTuple(awaited) || chunkWBSA6OG6_cjs.isPluginConfigObject(awaited)) {
       let pluginConfig;
       let pluginOptions;
-      if (chunk3MZQ4MQX_cjs.isPluginConfigTuple(awaited)) {
+      if (chunkWBSA6OG6_cjs.isPluginConfigTuple(awaited)) {
         pluginConfig = awaited[0];
         pluginOptions = awaited?.length === 2 ? awaited[1] : void 0;
       } else {
@@ -938,17 +932,17 @@ ${formatTypes(generatedTypes)}
         }
       } else if (isFunction.isFunction(pluginConfig)) {
         plugin = await Promise.resolve(pluginConfig(pluginOptions));
-      } else if (chunk3MZQ4MQX_cjs.isPlugin(pluginConfig)) {
+      } else if (chunkWBSA6OG6_cjs.isPlugin(pluginConfig)) {
         plugin = pluginConfig;
       }
     }
     if (!plugin) {
       throw new Error(`The plugin configuration ${JSON.stringify(awaited)} is invalid. This configuration must point to a valid Powerlines plugin module.`);
     }
-    if (!chunk3MZQ4MQX_cjs.isPlugin(plugin)) {
+    if (!chunkWBSA6OG6_cjs.isPlugin(plugin)) {
       throw new Error(`The plugin option ${JSON.stringify(plugin)} does not export a valid module. This configuration must point to a valid Powerlines plugin module.`);
     }
-    if (chunk3MZQ4MQX_cjs.checkDedupe(plugin, this.context.plugins)) {
+    if (chunkWBSA6OG6_cjs.checkDedupe(plugin, this.context.plugins)) {
       this.context.log(types.LogLevelLabel.TRACE, `Duplicate ${chalk2__default.default.bold.cyanBright(plugin.name)} plugin dependency detected - Skipping initialization.`);
       return null;
     }

package/dist/lib/{chunk-H6EOZSIZ.js → chunk-TAVG226Z.js}

@@ -115,7 +115,7 @@ function extractRollupConfig(context) {
   }, context.config.build.variant === "rollup" ? context.config.build.override : {}, context.config.build.variant === "vite" ? context.config.build.override.build?.rollupOptions : {}, {
     cache: !context.config.skipCache ? joinPaths(context.cachePath, "rollup") : false,
     output: {
-      dir: context.config.output.distPath
+      dir: context.config.output.buildPath
     },
     logLevel: context.config.logLevel
   }, context.config.build.variant === "rollup" ? context.config.build : {}, context.config.build.variant === "vite" ? context.config.build.build?.rollupOptions : {}, {

package/dist/lib/{chunk-DALRRHB4.cjs → chunk-TSFG3WEA.cjs}

@@ -126,7 +126,7 @@ function extractRollupConfig(context) {
   }, context.config.build.variant === "rollup" ? context.config.build.override : {}, context.config.build.variant === "vite" ? context.config.build.override.build?.rollupOptions : {}, {
     cache: !context.config.skipCache ? joinPaths.joinPaths(context.cachePath, "rollup") : false,
     output: {
-      dir: context.config.output.distPath
+      dir: context.config.output.buildPath
     },
     logLevel: context.config.logLevel
   }, context.config.build.variant === "rollup" ? context.config.build : {}, context.config.build.variant === "vite" ? context.config.build.build?.rollupOptions : {}, {

package/dist/lib/{chunk-RMA2PMP7.cjs → chunk-TZCC5IWH.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkTOCNXURI_cjs = require('./chunk-TOCNXURI.cjs');
+var chunkWCXA5WFX_cjs = require('./chunk-WCXA5WFX.cjs');
 var chunkUSNT2KNT_cjs = require('./chunk-USNT2KNT.cjs');
 var joinPaths = require('@stryke/path/join-paths');
 var defu = require('defu');
@@ -62,11 +62,11 @@ function extractViteConfig(context) {
     mode: context.config.mode === "development" ? "development" : "production",
     cacheDir: joinPaths.joinPaths(context.cachePath, "vite"),
     build: {
-      outDir: context.config.output.distPath,
+      outDir: context.config.output.buildPath,
       tsconfig: context.tsconfig.tsconfigFilePath,
       tsconfigRaw: context.tsconfig.tsconfigJson
     },
-    esbuild: chunkTOCNXURI_cjs.extractESBuildConfig(context),
+    esbuild: chunkWCXA5WFX_cjs.extractESBuildConfig(context),
     logLevel: context.config.logLevel ?? void 0,
     envDir: context.config.projectRoot
   }, context.config.build.variant === "vite" ? context.config.build : {}, {

package/dist/lib/chunk-VHCBD2IS.js

@@ -0,0 +1,149 @@
+import { __name } from './chunk-SHUYVCID.js';
+import { appendPath } from '@stryke/path/append';
+import { correctPath } from '@stryke/path/correct-path';
+import { joinPaths } from '@stryke/path/join';
+import { resolve } from 'node:path';
+
+var BaseStorageAdapter = class {
+  static {
+    __name(this, "BaseStorageAdapter");
+  }
+  /**
+  * Indicates whether the storage adapter has been disposed.
+  */
+  #isDisposed = false;
+  /**
+  * Configuration options for the storage adapter.
+  */
+  options;
+  /**
+  * Constructor for the BaseStorageAdapter.
+  *
+  * @param options - Configuration options for the storage adapter.
+  */
+  constructor(options = {
+    base: "/"
+  }) {
+    this.options = options;
+    this.options.base = resolve(options.base);
+    this.options.isReadOnly = !!options.isReadOnly;
+  }
+  /**
+  * Asynchronously checks if a key exists in the storage.
+  *
+  * @param key - The key to check for existence.
+  * @returns A promise that resolves to `true` if the key exists, otherwise `false`.
+  */
+  async exists(key) {
+    return this.existsSync(key);
+  }
+  /**
+  * Asynchronously retrieves the value associated with a given key.
+  *
+  * @param key - The key whose value is to be retrieved.
+  * @returns A promise that resolves to the value associated with the key, or `null` if the key does not exist.
+  */
+  async get(key) {
+    return this.getSync(key);
+  }
+  /**
+  * Asynchronously sets the value for a given key.
+  *
+  * @param key - The key to set the value for.
+  * @param value - The value to set.
+  */
+  async set(key, value) {
+    if (!this.options.isReadOnly) {
+      this.setSync(key, value);
+    }
+  }
+  /**
+  * Asynchronously removes a key from the storage.
+  *
+  * @param key - The key to remove.
+  */
+  async remove(key) {
+    if (!this.options.isReadOnly) {
+      this.removeSync(key);
+    }
+  }
+  /**
+  * Synchronously removes all entries from the storage that match the provided base path.
+  *
+  * @param base - The base path to clear keys from.
+  */
+  clearSync(base) {
+    if (!this.options.isReadOnly) {
+      const keys = this.listSync(base || this.options.base);
+      if (!keys.length) {
+        return;
+      }
+      keys.map((key) => this.removeSync(base && !key.startsWith(base) ? joinPaths(base, key) : key));
+    }
+  }
+  /**
+  * Asynchronously removes all entries from the storage that match the provided base path.
+  *
+  * @param base - The base path to clear keys from.
+  * @returns A promise that resolves when the operation is complete.
+  */
+  async clear(base) {
+    if (!this.options.isReadOnly) {
+      const keys = await this.list(base || this.options.base);
+      if (!keys.length) {
+        return;
+      }
+      await Promise.all(keys.map(async (key) => this.remove(base && !key.startsWith(base) ? joinPaths(base, key) : key)));
+    }
+  }
+  /**
+  * Asynchronously lists all keys under a given base path.
+  *
+  * @param base - The base path to list keys from.
+  * @returns A promise that resolves to an array of keys under the specified base path.
+  */
+  async list(base) {
+    return this.listSync(base);
+  }
+  /**
+  * Disposes of the storage adapter, releasing any held resources.
+  *
+  * @returns A promise that resolves when the disposal is complete.
+  */
+  dispose() {
+    return Promise.resolve();
+  }
+  /**
+  * Async dispose method to clean up resources.
+  *
+  * @returns A promise that resolves when disposal is complete.
+  */
+  async [Symbol.asyncDispose]() {
+    return this._dispose();
+  }
+  /**
+  * Resolves a given key to its full path within the storage adapter.
+  *
+  * @param key - The key to resolve.
+  * @returns The resolved full path for the key.
+  */
+  resolve(key = this.options.base) {
+    if (/\.\.:|\.\.$/.test(key)) {
+      throw new Error(`[${this.name}]: Invalid key: ${JSON.stringify(key)} provided to storage adapter.`);
+    }
+    return appendPath(correctPath(key).replace(/:/g, "/"), this.options.base);
+  }
+  /**
+  * Disposes of the storage adapter, releasing any held resources.
+  *
+  * @returns A promise that resolves when the disposal is complete.
+  */
+  async _dispose() {
+    if (!this.#isDisposed) {
+      await Promise.resolve(this.dispose());
+      this.#isDisposed = true;
+    }
+  }
+};
+
+export { BaseStorageAdapter };

package/dist/lib/{chunk-HY6DNFCT.js → chunk-VODWHWD6.js}

@@ -1,4 +1,4 @@
-import { extractESBuildConfig } from './chunk-AOHJEL2Q.js';
+import { extractESBuildConfig } from './chunk-WOKPJMGJ.js';
 import { __name } from './chunk-SHUYVCID.js';
 import { joinPaths } from '@stryke/path/join-paths';
 import defu from 'defu';
@@ -56,7 +56,7 @@ function extractViteConfig(context) {
     mode: context.config.mode === "development" ? "development" : "production",
     cacheDir: joinPaths(context.cachePath, "vite"),
     build: {
-      outDir: context.config.output.distPath,
+      outDir: context.config.output.buildPath,
       tsconfig: context.tsconfig.tsconfigFilePath,
       tsconfigRaw: context.tsconfig.tsconfigJson
     },

package/dist/lib/{chunk-2X5DUDNT.js → chunk-W6GWSJ22.js}

@@ -1,5 +1,5 @@
 import { getString } from './chunk-M263EZ4F.js';
-import { extractRollupConfig } from './chunk-H6EOZSIZ.js';
+import { extractRollupConfig } from './chunk-TAVG226Z.js';
 import { __name } from './chunk-SHUYVCID.js';
 import { joinPaths } from '@stryke/path/join-paths';
 import { isObject } from '@stryke/type-checks/is-object';
@@ -129,7 +129,7 @@ function extractUnbuildConfig(context) {
     orgName: isObject(context.workspaceConfig.organization) ? context.workspaceConfig.organization.name : context.workspaceConfig.organization,
     sourceRoot: context.config.sourceRoot,
     projectRoot: context.config.projectRoot,
-    outputPath: context.config.output.distPath || "dist",
+    outputPath: context.config.output.buildPath || "dist",
     platform: context.config.build.platform,
     external: context.builtins.reduce((ret, id) => {
       if (!ret.includes(id)) {