@powerlines/engine 0.43.30 → 0.44.0

package/dist/{virtual-gIlTc3Lj.mjs → virtual-CUgOdyIa.mjs}

@@ -1,4 +1,5 @@
 import { joinPaths } from "@stryke/path/join";
+import { isSetString } from "@stryke/type-checks/is-set-string";
 import { getFileHeaderWarningText } from "@powerlines/core/lib/utilities/file-header";
 import { exists, existsSync } from "@stryke/fs/exists";
 import { createDirectory, createDirectorySync } from "@stryke/fs/helpers";
@@ -6,7 +7,6 @@ import { listFiles, listFilesSync } from "@stryke/fs/list-files";
 import { appendPath } from "@stryke/path/append";
 import { isParentPath } from "@stryke/path/is-parent-path";
 import { isError } from "@stryke/type-checks/is-error";
-import { isSetString } from "@stryke/type-checks/is-set-string";
 import { correctPath } from "@stryke/path/correct-path";
 import { isDirectory, isFile } from "@stryke/fs/is-file";
 import { readFile, readFileSync } from "@stryke/fs/read-file";
@@ -510,4 +510,4 @@ var VirtualStorageAdapter = class extends BaseStorageAdapter {
 
 //#endregion
 export { isFileError as a, ignoreNotfound as i, FileSystemStorageAdapter as n, BaseStorageAdapter as o, ignoreExists as r, VirtualStorageAdapter as t };
-//# sourceMappingURL=virtual-gIlTc3Lj.mjs.map
+//# sourceMappingURL=virtual-CUgOdyIa.mjs.map

package/dist/{virtual-gIlTc3Lj.mjs.map → virtual-CUgOdyIa.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"virtual-gIlTc3Lj.mjs","names":["#isDisposed"],"sources":["../src/storage/base.ts","../src/storage/helpers.ts","../src/storage/file-system.ts","../src/storage/virtual.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Context, StorageAdapter, StoragePreset } from \"@powerlines/core\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { correctPath } from \"@stryke/path/correct-path\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { MaybePromise } from \"@stryke/types/base\";\nimport { resolve } from \"node:path\";\n\nexport interface StorageAdapterOptions {\n  base: string;\n  isReadOnly?: boolean;\n  ignore?: string | string[];\n}\n\n/**\n * Abstract base class for storage adapters, providing a template for storage operations.\n */\nexport abstract class BaseStorageAdapter<\n  TOptions extends StorageAdapterOptions = StorageAdapterOptions\n> implements StorageAdapter {\n  /**\n   * Indicates whether the storage adapter has been disposed.\n   */\n  #isDisposed = false;\n\n  /**\n   * A name identifying the storage adapter type.\n   */\n  public abstract name: string;\n\n  /**\n   * Configuration options for the storage adapter.\n   */\n  public options: TOptions;\n\n  /**\n   * The storage preset for the adapter.\n   *\n   * @remarks\n   * This can be used as an alternate way to identify the type of storage being used.\n   */\n  public readonly preset?: StoragePreset | null = null;\n\n  /**\n   * Constructor for the BaseStorageAdapter.\n   *\n   * @param context - The Powerlines context.\n   * @param options - Configuration options for the storage adapter.\n   */\n  public constructor(\n    protected context: Context,\n    options: TOptions = { base: \"/\" } as TOptions\n  ) {\n    this.options = options;\n    this.options.base = resolve(options.base);\n    this.options.isReadOnly = !!options.isReadOnly;\n  }\n\n  /**\n   * Synchronously checks if a key exists in the storage.\n   *\n   * @param key - The key to check for existence.\n   * @returns Returns `true` if the key exists, otherwise `false`.\n   */\n  public abstract existsSync(key: string): boolean;\n\n  /**\n   * Asynchronously checks if a key exists in the storage.\n   *\n   * @param key - The key to check for existence.\n   * @returns A promise that resolves to `true` if the key exists, otherwise `false`.\n   */\n  public async exists(key: string): Promise<boolean> {\n    return this.existsSync(key);\n  }\n\n  /**\n   * Synchronously retrieves the value associated with a given key.\n   *\n   * @param key - The key whose value is to be retrieved.\n   * @returns The value associated with the key, or `null` if the key does not exist.\n   */\n  public abstract getSync(key: string): string | null;\n\n  /**\n   * Asynchronously retrieves the value associated with a given key.\n   *\n   * @param key - The key whose value is to be retrieved.\n   * @returns A promise that resolves to the value associated with the key, or `null` if the key does not exist.\n   */\n  public async get(key: string): Promise<string | null> {\n    return this.getSync(key);\n  }\n\n  /**\n   * Synchronously sets the value for a given key.\n   *\n   * @param key - The key to set the value for.\n   * @param value - The value to set.\n   */\n  public abstract setSync(key: string, value: string): void;\n\n  /**\n   * Asynchronously sets the value for a given key.\n   *\n   * @param key - The key to set the value for.\n   * @param value - The value to set.\n   */\n  public async set(key: string, value: string): Promise<void> {\n    if (!this.isReadOnly && (!this.existsSync(key) || this.overwrite)) {\n      this.setSync(key, value);\n    }\n  }\n\n  /**\n   * Synchronously creates a directory at the specified path.\n   *\n   * @param _ - The path of the directory to create.\n   */\n  public mkdirSync(_: string) {}\n\n  /**\n   * Creates a directory at the specified path.\n   *\n   * @param dirPath - The path of the directory to create.\n   */\n  public async mkdir(dirPath: string): Promise<void> {\n    return Promise.resolve(this.mkdirSync(dirPath));\n  }\n\n  /**\n   * Synchronously removes a key from the storage.\n   *\n   * @param key - The key to remove.\n   */\n  public abstract removeSync(key: string): void;\n\n  /**\n   * Asynchronously removes a key from the storage.\n   *\n   * @param key - The key to remove.\n   */\n  public async remove(key: string): Promise<void> {\n    if (!this.isReadOnly && this.overwrite) {\n      this.removeSync(key);\n    }\n  }\n\n  /**\n   * Synchronously removes all entries from the storage that match the provided base path.\n   *\n   * @param base - The base path to clear keys from.\n   */\n  public clearSync(base?: string) {\n    if (!this.isReadOnly && this.overwrite) {\n      const keys = this.listSync(base || this.options.base);\n      if (!keys.length) {\n        return;\n      }\n\n      keys.map(key =>\n        this.removeSync(\n          base && !key.startsWith(base) ? joinPaths(base, key) : key\n        )\n      );\n    }\n  }\n\n  /**\n   * Asynchronously removes all entries from the storage that match the provided base path.\n   *\n   * @param base - The base path to clear keys from.\n   * @returns A promise that resolves when the operation is complete.\n   */\n  public async clear(base?: string): Promise<void> {\n    if (!this.isReadOnly && this.overwrite) {\n      const keys = await this.list(base || this.options.base);\n      if (!keys.length) {\n        return;\n      }\n\n      await Promise.all(\n        keys.map(async key =>\n          this.remove(\n            base && !key.startsWith(base) ? joinPaths(base, key) : key\n          )\n        )\n      );\n    }\n  }\n\n  /**\n   * Lists all keys under a given base path synchronously.\n   *\n   * @param base - The base path to list keys from.\n   * @returns An array of keys under the specified base path.\n   */\n  public abstract listSync(base?: string): string[];\n\n  /**\n   * Asynchronously lists all keys under a given base path.\n   *\n   * @param base - The base path to list keys from.\n   * @returns A promise that resolves to an array of keys under the specified base path.\n   */\n  public async list(base?: string): Promise<string[]> {\n    return this.listSync(base);\n  }\n\n  /**\n   * Synchronously checks if the given key is a directory.\n   *\n   * @param _ - The key to check.\n   * @returns `true` if the key is a directory, otherwise `false`.\n   */\n  public isDirectorySync(_: string): boolean {\n    return false;\n  }\n\n  /**\n   * Checks if the given key is a directory.\n   *\n   * @param key - The key to check.\n   * @returns A promise that resolves to `true` if the key is a directory, otherwise `false`.\n   */\n  public async isDirectory(key: string) {\n    return Promise.resolve(this.isDirectorySync(key));\n  }\n\n  /**\n   * Synchronously checks if the given key is a file.\n   *\n   * @param key - The key to check.\n   * @returns `true` if the key is a file, otherwise `false`.\n   */\n  public isFileSync(key: string): boolean {\n    return this.existsSync(key) && !this.isDirectorySync(key);\n  }\n\n  /**\n   * Checks if the given key is a file.\n   *\n   * @param key - The key to check.\n   * @returns A promise that resolves to `true` if the key is a file, otherwise `false`.\n   */\n  public async isFile(key: string) {\n    return Promise.resolve(this.isFileSync(key));\n  }\n\n  /**\n   * Disposes of the storage adapter, releasing any held resources.\n   *\n   * @returns A promise that resolves when the disposal is complete.\n   */\n  public dispose(): MaybePromise<void> {\n    return Promise.resolve();\n  }\n\n  /**\n   * Async dispose method to clean up resources.\n   *\n   * @returns A promise that resolves when disposal is complete.\n   */\n  public async [Symbol.asyncDispose]() {\n    return this._dispose();\n  }\n\n  /**\n   * Determines if the storage adapter is read-only based on the provided options.\n   *\n   * @returns `true` if the storage adapter is read-only, otherwise `false`.\n   */\n  protected get isReadOnly() {\n    return !!this.options.isReadOnly;\n  }\n\n  /**\n   * Determines if the storage adapter should overwrite existing keys based on the provided options and context configuration.\n   *\n   * @returns `true` if the storage adapter should overwrite existing keys, otherwise `false`.\n   */\n  protected get overwrite() {\n    return !this.isReadOnly && this.context.config.output.overwrite !== false;\n  }\n\n  /**\n   * Resolves a given key to its full path within the storage adapter.\n   *\n   * @param key - The key to resolve.\n   * @returns The resolved full path for the key.\n   */\n  protected resolve(key?: string) {\n    if (!key) {\n      return this.options.base;\n    }\n\n    if (/\\.\\.:|\\.\\.$/.test(key)) {\n      throw new Error(\n        `[${this.name}]: Invalid key: ${JSON.stringify(key)} provided to storage adapter.`\n      );\n    }\n\n    return appendPath(correctPath(key).replace(/:/g, \"/\"), this.options.base);\n  }\n\n  /**\n   * Disposes of the storage adapter, releasing any held resources.\n   *\n   * @returns A promise that resolves when the disposal is complete.\n   */\n  protected async _dispose(): Promise<void> {\n    if (!this.#isDisposed) {\n      await Promise.resolve(this.dispose());\n      this.#isDisposed = true;\n    }\n  }\n}\n","/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { isError } from \"@stryke/type-checks/is-error\";\n\n/**\n * Checks if an error is a file system error.\n *\n * @param err - The error to check.\n * @returns `true` if the error is a file system error, otherwise `false`.\n */\nexport function isFileError(err: any) {\n  return isError(err) && \"code\" in err && err.code;\n}\n\n/**\n * Ignores file not found errors.\n *\n * @param err - The error to check.\n * @returns `null` if the error is a file not found error, otherwise returns the error.\n */\nexport function ignoreNotfound(err: any) {\n  return (\n    isFileError(err) &&\n    (err.code === \"ENOENT\" || err.code === \"EISDIR\" ? null : err)\n  );\n}\n\n/**\n * Ignores file exists errors.\n *\n * @param err - The error to check.\n * @returns `null` if the error is a file exists error, otherwise returns the error.\n */\nexport function ignoreExists(err: any) {\n  return isFileError(err) && err.code === \"EEXIST\" ? null : err;\n}\n","/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Context } from \"@powerlines/core\";\nimport { getFileHeaderWarningText } from \"@powerlines/core/lib/utilities/file-header\";\nimport { exists, existsSync } from \"@stryke/fs/exists\";\nimport { createDirectory, createDirectorySync } from \"@stryke/fs/helpers\";\nimport { isDirectory, isFile } from \"@stryke/fs/is-file\";\nimport { listFiles, listFilesSync } from \"@stryke/fs/list-files\";\nimport { readFile, readFileSync } from \"@stryke/fs/read-file\";\nimport { writeFile, writeFileSync } from \"@stryke/fs/write-file\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { unlinkSync } from \"node:fs\";\nimport { unlink } from \"node:fs/promises\";\nimport { BaseStorageAdapter, StorageAdapterOptions } from \"./base\";\nimport { ignoreNotfound } from \"./helpers\";\n\nexport type SetSyncOptions = Parameters<typeof writeFileSync>[2];\nexport type SetOptions = Parameters<typeof writeFile>[2];\n\n/**\n * File system storage adapter implementation.\n */\nexport class FileSystemStorageAdapter extends BaseStorageAdapter {\n  /**\n   * A name identifying the storage adapter type.\n   */\n  public name = \"file-system\";\n\n  /**\n   * The storage preset for the adapter.\n   *\n   * @remarks\n   * This can be used as an alternate way to identify the type of storage being used.\n   */\n  public override readonly preset = \"fs\";\n\n  /**\n   * Constructor for the FileSystemStorageAdapter.\n   *\n   * @param context - The Powerlines context.\n   * @param options - Configuration options for the storage adapter.\n   */\n  public constructor(context: Context, options?: StorageAdapterOptions) {\n    super(context, options);\n  }\n\n  /**\n   * Synchronously checks if a key exists in the storage.\n   *\n   * @param key - The key to check for existence.\n   * @returns Returns `true` if the key exists, otherwise `false`.\n   */\n  public existsSync(key: string): boolean {\n    return existsSync(this.resolve(key));\n  }\n\n  /**\n   * Asynchronously checks if a key exists in the storage.\n   *\n   * @param key - The key to check for existence.\n   * @returns A promise that resolves to `true` if the key exists, otherwise `false`.\n   */\n  public override async exists(key: string): Promise<boolean> {\n    return exists(this.resolve(key));\n  }\n\n  /**\n   * Synchronously retrieves the value associated with a given key.\n   *\n   * @param key - The key whose value is to be retrieved.\n   * @returns The value associated with the key, or `null` if the key does not exist.\n   */\n  public getSync(key: string): string | null {\n    return readFileSync(this.resolve(key));\n  }\n\n  /**\n   * Asynchronously retrieves the value associated with a given key.\n   *\n   * @param key - The key whose value is to be retrieved.\n   * @returns A promise that resolves to the value associated with the key, or `null` if the key does not exist.\n   */\n  public override async get(key: string): Promise<string | null> {\n    return readFile(this.resolve(key));\n  }\n\n  /**\n   * Synchronously sets the value for a given key.\n   *\n   * @param key - The key to set the value for.\n   * @param value - The value to set.\n   */\n  public setSync(key: string, value: string) {\n    if (!this.isReadOnly) {\n      if (this.existsSync(this.resolve(key)) && !this.overwrite) {\n        const existingValue = this.getSync(this.resolve(key));\n        if (\n          isSetString(existingValue) &&\n          existingValue.includes(\n            getFileHeaderWarningText(true, this.context.config.framework)\n          )\n        ) {\n          return writeFileSync(\n            this.resolve(key),\n            existingValue.replace(\n              getFileHeaderWarningText(true, this.context.config.framework),\n              getFileHeaderWarningText(false, this.context.config.framework)\n            )\n          );\n        }\n      } else {\n        return writeFileSync(this.resolve(key), value);\n      }\n    }\n  }\n\n  /**\n   * Asynchronously sets the value for a given key.\n   *\n   * @param key - The key to set the value for.\n   * @param value - The value to set.\n   */\n  public override async set(key: string, value: string): Promise<void> {\n    if (!this.isReadOnly) {\n      if (this.existsSync(this.resolve(key)) && !this.overwrite) {\n        const existingValue = await this.get(this.resolve(key));\n        if (\n          isSetString(existingValue) &&\n          existingValue.includes(\n            getFileHeaderWarningText(true, this.context.config.framework)\n          )\n        ) {\n          return writeFile(\n            this.resolve(key),\n            existingValue.replace(\n              getFileHeaderWarningText(true, this.context.config.framework),\n              getFileHeaderWarningText(false, this.context.config.framework)\n            )\n          );\n        }\n      } else {\n        return writeFile(this.resolve(key), value);\n      }\n    }\n  }\n\n  /**\n   * Synchronously removes a key from the storage.\n   *\n   * @param key - The key to remove.\n   */\n  public removeSync(key: string) {\n    if (!this.isReadOnly && this.overwrite) {\n      try {\n        return unlinkSync(this.resolve(key));\n      } catch (err) {\n        return ignoreNotfound(err);\n      }\n    }\n  }\n\n  /**\n   * Asynchronously removes a key from the storage.\n   *\n   * @param key - The key to remove.\n   */\n  public override async remove(key: string): Promise<void> {\n    if (!this.isReadOnly && this.overwrite) {\n      return unlink(this.resolve(key)).catch(ignoreNotfound);\n    }\n  }\n\n  /**\n   * Synchronously creates a directory at the specified path.\n   *\n   * @param dirPath - The path of the directory to create.\n   */\n  public override mkdirSync(dirPath: string) {\n    createDirectorySync(this.resolve(dirPath));\n  }\n\n  /**\n   * Creates a directory at the specified path.\n   *\n   * @param dirPath - The path of the directory to create.\n   */\n  public override async mkdir(dirPath: string): Promise<void> {\n    await createDirectory(this.resolve(dirPath));\n  }\n\n  /**\n   * Lists all keys under a given base path synchronously.\n   *\n   * @param base - The base path to list keys from.\n   * @returns An array of keys under the specified base path.\n   */\n  public listSync(base?: string): string[] {\n    try {\n      return listFilesSync(this.resolve(base), {\n        ignore: this.options.ignore\n      });\n    } catch (err) {\n      return ignoreNotfound(err) ?? [];\n    }\n  }\n\n  /**\n   * Asynchronously lists all keys under a given base path.\n   *\n   * @param base - The base path to list keys from.\n   * @returns A promise that resolves to an array of keys under the specified base path.\n   */\n  public override async list(base?: string): Promise<string[]> {\n    return listFiles(this.resolve(base), {\n      ignore: this.options.ignore\n    })\n      .catch(ignoreNotfound)\n      .then(r => r || []);\n  }\n\n  /**\n   * Synchronously checks if the given key is a directory.\n   *\n   * @param key - The key to check.\n   * @returns `true` if the key is a directory, otherwise `false`.\n   */\n  public override isDirectorySync(key: string): boolean {\n    return isDirectory(this.resolve(key));\n  }\n\n  /**\n   * Synchronously checks if the given key is a file.\n   *\n   * @param key - The key to check.\n   * @returns `true` if the key is a file, otherwise `false`.\n   */\n  public override isFileSync(key: string): boolean {\n    return isFile(this.resolve(key));\n  }\n}\n","/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Context } from \"@powerlines/core\";\nimport { isParentPath } from \"@stryke/path/is-parent-path\";\nimport { BaseStorageAdapter, StorageAdapterOptions } from \"./base\";\n\n/**\n * Virtual/in-memory storage adapter implementation.\n */\nexport class VirtualStorageAdapter extends BaseStorageAdapter {\n  /**\n   * A name identifying the storage adapter type.\n   */\n  public name = \"virtual\";\n\n  /**\n   * The storage preset for the adapter.\n   *\n   * @remarks\n   * This can be used as an alternate way to identify the type of storage being used.\n   */\n  public override readonly preset = \"virtual\";\n\n  /**\n   * In-memory data storage.\n   */\n  protected data = new Map<string, any>();\n\n  /**\n   * Constructor for the VirtualStorageAdapter.\n   *\n   * @param context - The Powerlines context.\n   * @param options - Configuration options for the storage adapter.\n   */\n  public constructor(context: Context, options?: StorageAdapterOptions) {\n    super(context, options);\n  }\n\n  /**\n   * Synchronously checks if a key exists in the storage.\n   *\n   * @param key - The key to check for existence.\n   * @returns Returns `true` if the key exists, otherwise `false`.\n   */\n  public existsSync(key: string): boolean {\n    return this.data.has(this.resolve(key));\n  }\n\n  /**\n   * Synchronously retrieves the value associated with a given key.\n   *\n   * @param key - The key whose value is to be retrieved.\n   * @returns The value associated with the key, or `null` if the key does not exist.\n   */\n  public getSync(key: string): string | null {\n    return this.data.get(this.resolve(key)) ?? null;\n  }\n\n  /**\n   * Synchronously sets the value for a given key.\n   *\n   * @param key - The key to set the value for.\n   * @param value - The value to set.\n   */\n  public setSync(key: string, value: string) {\n    if (!this.isReadOnly && (!this.existsSync(key) || this.overwrite)) {\n      this.data.set(this.resolve(key), value);\n    }\n  }\n\n  /**\n   * Synchronously removes a key from the storage.\n   *\n   * @param key - The key to remove.\n   */\n  public removeSync(key: string) {\n    if (!this.isReadOnly && this.overwrite) {\n      this.data.delete(this.resolve(key));\n    }\n  }\n\n  /**\n   * Lists all keys under a given base path synchronously.\n   *\n   * @param base - The base path to list keys from.\n   * @returns An array of keys under the specified base path.\n   */\n  public listSync(base?: string): string[] {\n    return [\n      ...this.data\n        .keys()\n        .filter(key => (!base ? true : isParentPath(key, this.resolve(base))))\n    ];\n  }\n\n  /**\n   * Disposes of the storage adapter, releasing any held resources.\n   *\n   * @returns A promise that resolves when the disposal is complete.\n   */\n  public override async dispose(): Promise<void> {\n    return this.clear();\n  }\n\n  /**\n   * Determines if the storage adapter should overwrite existing keys based on the provided options and context configuration.\n   *\n   * @returns `true` if the storage adapter should overwrite existing keys, otherwise `false`.\n   */\n  protected override get overwrite() {\n    return !this.isReadOnly;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"virtual-CUgOdyIa.mjs","names":["#isDisposed"],"sources":["../src/storage/base.ts","../src/storage/helpers.ts","../src/storage/file-system.ts","../src/storage/virtual.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Context, StorageAdapter, StoragePreset } from \"@powerlines/core\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { correctPath } from \"@stryke/path/correct-path\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { MaybePromise } from \"@stryke/types/base\";\nimport { resolve } from \"node:path\";\n\nexport interface StorageAdapterOptions {\n  base: string;\n  isReadOnly?: boolean;\n  ignore?: string | string[];\n}\n\n/**\n * Abstract base class for storage adapters, providing a template for storage operations.\n */\nexport abstract class BaseStorageAdapter<\n  TOptions extends StorageAdapterOptions = StorageAdapterOptions\n> implements StorageAdapter {\n  /**\n   * Indicates whether the storage adapter has been disposed.\n   */\n  #isDisposed = false;\n\n  /**\n   * A name identifying the storage adapter type.\n   */\n  public abstract name: string;\n\n  /**\n   * Configuration options for the storage adapter.\n   */\n  public options: TOptions;\n\n  /**\n   * The storage preset for the adapter.\n   *\n   * @remarks\n   * This can be used as an alternate way to identify the type of storage being used.\n   */\n  public readonly preset?: StoragePreset | null = null;\n\n  /**\n   * Constructor for the BaseStorageAdapter.\n   *\n   * @param context - The Powerlines context.\n   * @param options - Configuration options for the storage adapter.\n   */\n  public constructor(\n    protected context: Context,\n    options: TOptions = { base: \"/\" } as TOptions\n  ) {\n    this.options = options;\n    this.options.base = resolve(options.base);\n    this.options.isReadOnly = !!options.isReadOnly;\n  }\n\n  /**\n   * Synchronously checks if a key exists in the storage.\n   *\n   * @param key - The key to check for existence.\n   * @returns Returns `true` if the key exists, otherwise `false`.\n   */\n  public abstract existsSync(key: string): boolean;\n\n  /**\n   * Asynchronously checks if a key exists in the storage.\n   *\n   * @param key - The key to check for existence.\n   * @returns A promise that resolves to `true` if the key exists, otherwise `false`.\n   */\n  public async exists(key: string): Promise<boolean> {\n    return this.existsSync(key);\n  }\n\n  /**\n   * Synchronously retrieves the value associated with a given key.\n   *\n   * @param key - The key whose value is to be retrieved.\n   * @returns The value associated with the key, or `null` if the key does not exist.\n   */\n  public abstract getSync(key: string): string | null;\n\n  /**\n   * Asynchronously retrieves the value associated with a given key.\n   *\n   * @param key - The key whose value is to be retrieved.\n   * @returns A promise that resolves to the value associated with the key, or `null` if the key does not exist.\n   */\n  public async get(key: string): Promise<string | null> {\n    return this.getSync(key);\n  }\n\n  /**\n   * Synchronously sets the value for a given key.\n   *\n   * @param key - The key to set the value for.\n   * @param value - The value to set.\n   */\n  public abstract setSync(key: string, value: string): void;\n\n  /**\n   * Asynchronously sets the value for a given key.\n   *\n   * @param key - The key to set the value for.\n   * @param value - The value to set.\n   */\n  public async set(key: string, value: string): Promise<void> {\n    if (!this.isReadOnly && (!this.existsSync(key) || this.overwrite)) {\n      this.setSync(key, value);\n    }\n  }\n\n  /**\n   * Synchronously creates a directory at the specified path.\n   *\n   * @param _ - The path of the directory to create.\n   */\n  public mkdirSync(_: string) {}\n\n  /**\n   * Creates a directory at the specified path.\n   *\n   * @param dirPath - The path of the directory to create.\n   */\n  public async mkdir(dirPath: string): Promise<void> {\n    return Promise.resolve(this.mkdirSync(dirPath));\n  }\n\n  /**\n   * Synchronously removes a key from the storage.\n   *\n   * @param key - The key to remove.\n   */\n  public abstract removeSync(key: string): void;\n\n  /**\n   * Asynchronously removes a key from the storage.\n   *\n   * @param key - The key to remove.\n   */\n  public async remove(key: string): Promise<void> {\n    if (!this.isReadOnly && this.overwrite) {\n      this.removeSync(key);\n    }\n  }\n\n  /**\n   * Synchronously removes all entries from the storage that match the provided base path.\n   *\n   * @param base - The base path to clear keys from.\n   */\n  public clearSync(base?: string) {\n    if (!this.isReadOnly && this.overwrite) {\n      const keys = this.listSync(base || this.options.base);\n      if (!keys.length) {\n        return;\n      }\n\n      keys.map(key =>\n        this.removeSync(\n          base && !key.startsWith(base) ? joinPaths(base, key) : key\n        )\n      );\n    }\n  }\n\n  /**\n   * Asynchronously removes all entries from the storage that match the provided base path.\n   *\n   * @param base - The base path to clear keys from.\n   * @returns A promise that resolves when the operation is complete.\n   */\n  public async clear(base?: string): Promise<void> {\n    if (!this.isReadOnly && this.overwrite) {\n      const keys = await this.list(base || this.options.base);\n      if (!keys.length) {\n        return;\n      }\n\n      await Promise.all(\n        keys.map(async key =>\n          this.remove(\n            base && !key.startsWith(base) ? joinPaths(base, key) : key\n          )\n        )\n      );\n    }\n  }\n\n  /**\n   * Lists all keys under a given base path synchronously.\n   *\n   * @param base - The base path to list keys from.\n   * @returns An array of keys under the specified base path.\n   */\n  public abstract listSync(base?: string): string[];\n\n  /**\n   * Asynchronously lists all keys under a given base path.\n   *\n   * @param base - The base path to list keys from.\n   * @returns A promise that resolves to an array of keys under the specified base path.\n   */\n  public async list(base?: string): Promise<string[]> {\n    return this.listSync(base);\n  }\n\n  /**\n   * Synchronously checks if the given key is a directory.\n   *\n   * @param _ - The key to check.\n   * @returns `true` if the key is a directory, otherwise `false`.\n   */\n  public isDirectorySync(_: string): boolean {\n    return false;\n  }\n\n  /**\n   * Checks if the given key is a directory.\n   *\n   * @param key - The key to check.\n   * @returns A promise that resolves to `true` if the key is a directory, otherwise `false`.\n   */\n  public async isDirectory(key: string) {\n    return Promise.resolve(this.isDirectorySync(key));\n  }\n\n  /**\n   * Synchronously checks if the given key is a file.\n   *\n   * @param key - The key to check.\n   * @returns `true` if the key is a file, otherwise `false`.\n   */\n  public isFileSync(key: string): boolean {\n    return this.existsSync(key) && !this.isDirectorySync(key);\n  }\n\n  /**\n   * Checks if the given key is a file.\n   *\n   * @param key - The key to check.\n   * @returns A promise that resolves to `true` if the key is a file, otherwise `false`.\n   */\n  public async isFile(key: string) {\n    return Promise.resolve(this.isFileSync(key));\n  }\n\n  /**\n   * Disposes of the storage adapter, releasing any held resources.\n   *\n   * @returns A promise that resolves when the disposal is complete.\n   */\n  public dispose(): MaybePromise<void> {\n    return Promise.resolve();\n  }\n\n  /**\n   * Async dispose method to clean up resources.\n   *\n   * @returns A promise that resolves when disposal is complete.\n   */\n  public async [Symbol.asyncDispose]() {\n    return this._dispose();\n  }\n\n  /**\n   * Determines if the storage adapter is read-only based on the provided options.\n   *\n   * @returns `true` if the storage adapter is read-only, otherwise `false`.\n   */\n  protected get isReadOnly() {\n    return !!this.options.isReadOnly;\n  }\n\n  /**\n   * Determines if the storage adapter should overwrite existing keys based on the provided options and context configuration.\n   *\n   * @returns `true` if the storage adapter should overwrite existing keys, otherwise `false`.\n   */\n  protected get overwrite() {\n    return !this.isReadOnly && this.context.config.output.overwrite !== false;\n  }\n\n  /**\n   * Resolves a given key to its full path within the storage adapter.\n   *\n   * @param key - The key to resolve.\n   * @returns The resolved full path for the key.\n   */\n  protected resolve(key?: string) {\n    if (!key) {\n      return this.options.base;\n    }\n\n    if (/\\.\\.:|\\.\\.$/.test(key)) {\n      throw new Error(\n        `[${this.name}]: Invalid key: ${JSON.stringify(key)} provided to storage adapter.`\n      );\n    }\n\n    return appendPath(correctPath(key).replace(/:/g, \"/\"), this.options.base);\n  }\n\n  /**\n   * Disposes of the storage adapter, releasing any held resources.\n   *\n   * @returns A promise that resolves when the disposal is complete.\n   */\n  protected async _dispose(): Promise<void> {\n    if (!this.#isDisposed) {\n      await Promise.resolve(this.dispose());\n      this.#isDisposed = true;\n    }\n  }\n}\n","/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { isError } from \"@stryke/type-checks/is-error\";\n\n/**\n * Checks if an error is a file system error.\n *\n * @param err - The error to check.\n * @returns `true` if the error is a file system error, otherwise `false`.\n */\nexport function isFileError(err: any) {\n  return isError(err) && \"code\" in err && err.code;\n}\n\n/**\n * Ignores file not found errors.\n *\n * @param err - The error to check.\n * @returns `null` if the error is a file not found error, otherwise returns the error.\n */\nexport function ignoreNotfound(err: any) {\n  return (\n    isFileError(err) &&\n    (err.code === \"ENOENT\" || err.code === \"EISDIR\" ? null : err)\n  );\n}\n\n/**\n * Ignores file exists errors.\n *\n * @param err - The error to check.\n * @returns `null` if the error is a file exists error, otherwise returns the error.\n */\nexport function ignoreExists(err: any) {\n  return isFileError(err) && err.code === \"EEXIST\" ? null : err;\n}\n","/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Context } from \"@powerlines/core\";\nimport { getFileHeaderWarningText } from \"@powerlines/core/lib/utilities/file-header\";\nimport { exists, existsSync } from \"@stryke/fs/exists\";\nimport { createDirectory, createDirectorySync } from \"@stryke/fs/helpers\";\nimport { isDirectory, isFile } from \"@stryke/fs/is-file\";\nimport { listFiles, listFilesSync } from \"@stryke/fs/list-files\";\nimport { readFile, readFileSync } from \"@stryke/fs/read-file\";\nimport { writeFile, writeFileSync } from \"@stryke/fs/write-file\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { unlinkSync } from \"node:fs\";\nimport { unlink } from \"node:fs/promises\";\nimport { BaseStorageAdapter, StorageAdapterOptions } from \"./base\";\nimport { ignoreNotfound } from \"./helpers\";\n\nexport type SetSyncOptions = Parameters<typeof writeFileSync>[2];\nexport type SetOptions = Parameters<typeof writeFile>[2];\n\n/**\n * File system storage adapter implementation.\n */\nexport class FileSystemStorageAdapter extends BaseStorageAdapter {\n  /**\n   * A name identifying the storage adapter type.\n   */\n  public name = \"file-system\";\n\n  /**\n   * The storage preset for the adapter.\n   *\n   * @remarks\n   * This can be used as an alternate way to identify the type of storage being used.\n   */\n  public override readonly preset = \"fs\";\n\n  /**\n   * Constructor for the FileSystemStorageAdapter.\n   *\n   * @param context - The Powerlines context.\n   * @param options - Configuration options for the storage adapter.\n   */\n  public constructor(context: Context, options?: StorageAdapterOptions) {\n    super(context, options);\n  }\n\n  /**\n   * Synchronously checks if a key exists in the storage.\n   *\n   * @param key - The key to check for existence.\n   * @returns Returns `true` if the key exists, otherwise `false`.\n   */\n  public existsSync(key: string): boolean {\n    return existsSync(this.resolve(key));\n  }\n\n  /**\n   * Asynchronously checks if a key exists in the storage.\n   *\n   * @param key - The key to check for existence.\n   * @returns A promise that resolves to `true` if the key exists, otherwise `false`.\n   */\n  public override async exists(key: string): Promise<boolean> {\n    return exists(this.resolve(key));\n  }\n\n  /**\n   * Synchronously retrieves the value associated with a given key.\n   *\n   * @param key - The key whose value is to be retrieved.\n   * @returns The value associated with the key, or `null` if the key does not exist.\n   */\n  public getSync(key: string): string | null {\n    return readFileSync(this.resolve(key));\n  }\n\n  /**\n   * Asynchronously retrieves the value associated with a given key.\n   *\n   * @param key - The key whose value is to be retrieved.\n   * @returns A promise that resolves to the value associated with the key, or `null` if the key does not exist.\n   */\n  public override async get(key: string): Promise<string | null> {\n    return readFile(this.resolve(key));\n  }\n\n  /**\n   * Synchronously sets the value for a given key.\n   *\n   * @param key - The key to set the value for.\n   * @param value - The value to set.\n   */\n  public setSync(key: string, value: string) {\n    if (!this.isReadOnly) {\n      if (this.existsSync(this.resolve(key)) && !this.overwrite) {\n        const existingValue = this.getSync(this.resolve(key));\n        if (\n          isSetString(existingValue) &&\n          existingValue.includes(\n            getFileHeaderWarningText(true, this.context.config.framework)\n          )\n        ) {\n          return writeFileSync(\n            this.resolve(key),\n            existingValue.replace(\n              getFileHeaderWarningText(true, this.context.config.framework),\n              getFileHeaderWarningText(false, this.context.config.framework)\n            )\n          );\n        }\n      } else {\n        return writeFileSync(this.resolve(key), value);\n      }\n    }\n  }\n\n  /**\n   * Asynchronously sets the value for a given key.\n   *\n   * @param key - The key to set the value for.\n   * @param value - The value to set.\n   */\n  public override async set(key: string, value: string): Promise<void> {\n    if (!this.isReadOnly) {\n      if (this.existsSync(this.resolve(key)) && !this.overwrite) {\n        const existingValue = await this.get(this.resolve(key));\n        if (\n          isSetString(existingValue) &&\n          existingValue.includes(\n            getFileHeaderWarningText(true, this.context.config.framework)\n          )\n        ) {\n          return writeFile(\n            this.resolve(key),\n            existingValue.replace(\n              getFileHeaderWarningText(true, this.context.config.framework),\n              getFileHeaderWarningText(false, this.context.config.framework)\n            )\n          );\n        }\n      } else {\n        return writeFile(this.resolve(key), value);\n      }\n    }\n  }\n\n  /**\n   * Synchronously removes a key from the storage.\n   *\n   * @param key - The key to remove.\n   */\n  public removeSync(key: string) {\n    if (!this.isReadOnly && this.overwrite) {\n      try {\n        return unlinkSync(this.resolve(key));\n      } catch (err) {\n        return ignoreNotfound(err);\n      }\n    }\n  }\n\n  /**\n   * Asynchronously removes a key from the storage.\n   *\n   * @param key - The key to remove.\n   */\n  public override async remove(key: string): Promise<void> {\n    if (!this.isReadOnly && this.overwrite) {\n      return unlink(this.resolve(key)).catch(ignoreNotfound);\n    }\n  }\n\n  /**\n   * Synchronously creates a directory at the specified path.\n   *\n   * @param dirPath - The path of the directory to create.\n   */\n  public override mkdirSync(dirPath: string) {\n    createDirectorySync(this.resolve(dirPath));\n  }\n\n  /**\n   * Creates a directory at the specified path.\n   *\n   * @param dirPath - The path of the directory to create.\n   */\n  public override async mkdir(dirPath: string): Promise<void> {\n    await createDirectory(this.resolve(dirPath));\n  }\n\n  /**\n   * Lists all keys under a given base path synchronously.\n   *\n   * @param base - The base path to list keys from.\n   * @returns An array of keys under the specified base path.\n   */\n  public listSync(base?: string): string[] {\n    try {\n      return listFilesSync(this.resolve(base), {\n        ignore: this.options.ignore\n      });\n    } catch (err) {\n      return ignoreNotfound(err) ?? [];\n    }\n  }\n\n  /**\n   * Asynchronously lists all keys under a given base path.\n   *\n   * @param base - The base path to list keys from.\n   * @returns A promise that resolves to an array of keys under the specified base path.\n   */\n  public override async list(base?: string): Promise<string[]> {\n    return listFiles(this.resolve(base), {\n      ignore: this.options.ignore\n    })\n      .catch(ignoreNotfound)\n      .then(r => r || []);\n  }\n\n  /**\n   * Synchronously checks if the given key is a directory.\n   *\n   * @param key - The key to check.\n   * @returns `true` if the key is a directory, otherwise `false`.\n   */\n  public override isDirectorySync(key: string): boolean {\n    return isDirectory(this.resolve(key));\n  }\n\n  /**\n   * Synchronously checks if the given key is a file.\n   *\n   * @param key - The key to check.\n   * @returns `true` if the key is a file, otherwise `false`.\n   */\n  public override isFileSync(key: string): boolean {\n    return isFile(this.resolve(key));\n  }\n}\n","/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Context } from \"@powerlines/core\";\nimport { isParentPath } from \"@stryke/path/is-parent-path\";\nimport { BaseStorageAdapter, StorageAdapterOptions } from \"./base\";\n\n/**\n * Virtual/in-memory storage adapter implementation.\n */\nexport class VirtualStorageAdapter extends BaseStorageAdapter {\n  /**\n   * A name identifying the storage adapter type.\n   */\n  public name = \"virtual\";\n\n  /**\n   * The storage preset for the adapter.\n   *\n   * @remarks\n   * This can be used as an alternate way to identify the type of storage being used.\n   */\n  public override readonly preset = \"virtual\";\n\n  /**\n   * In-memory data storage.\n   */\n  protected data = new Map<string, any>();\n\n  /**\n   * Constructor for the VirtualStorageAdapter.\n   *\n   * @param context - The Powerlines context.\n   * @param options - Configuration options for the storage adapter.\n   */\n  public constructor(context: Context, options?: StorageAdapterOptions) {\n    super(context, options);\n  }\n\n  /**\n   * Synchronously checks if a key exists in the storage.\n   *\n   * @param key - The key to check for existence.\n   * @returns Returns `true` if the key exists, otherwise `false`.\n   */\n  public existsSync(key: string): boolean {\n    return this.data.has(this.resolve(key));\n  }\n\n  /**\n   * Synchronously retrieves the value associated with a given key.\n   *\n   * @param key - The key whose value is to be retrieved.\n   * @returns The value associated with the key, or `null` if the key does not exist.\n   */\n  public getSync(key: string): string | null {\n    return this.data.get(this.resolve(key)) ?? null;\n  }\n\n  /**\n   * Synchronously sets the value for a given key.\n   *\n   * @param key - The key to set the value for.\n   * @param value - The value to set.\n   */\n  public setSync(key: string, value: string) {\n    if (!this.isReadOnly && (!this.existsSync(key) || this.overwrite)) {\n      this.data.set(this.resolve(key), value);\n    }\n  }\n\n  /**\n   * Synchronously removes a key from the storage.\n   *\n   * @param key - The key to remove.\n   */\n  public removeSync(key: string) {\n    if (!this.isReadOnly && this.overwrite) {\n      this.data.delete(this.resolve(key));\n    }\n  }\n\n  /**\n   * Lists all keys under a given base path synchronously.\n   *\n   * @param base - The base path to list keys from.\n   * @returns An array of keys under the specified base path.\n   */\n  public listSync(base?: string): string[] {\n    return [\n      ...this.data\n        .keys()\n        .filter(key => (!base ? true : isParentPath(key, this.resolve(base))))\n    ];\n  }\n\n  /**\n   * Disposes of the storage adapter, releasing any held resources.\n   *\n   * @returns A promise that resolves when the disposal is complete.\n   */\n  public override async dispose(): Promise<void> {\n    return this.clear();\n  }\n\n  /**\n   * Determines if the storage adapter should overwrite existing keys based on the provided options and context configuration.\n   *\n   * @returns `true` if the storage adapter should overwrite existing keys, otherwise `false`.\n   */\n  protected override get overwrite() {\n    return !this.isReadOnly;\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerlines/engine",
-  "version": "0.43.30",
+  "version": "0.44.0",
   "private": false,
   "description": "An internal package containing the core engine modules for Powerlines.",
   "homepage": "https://stormsoftware.com",
@@ -137,7 +137,7 @@
     "@cacheable/memory": "^2.0.8",
     "@donedeal0/superdiff": "^3.2.0",
     "@jridgewell/sourcemap-codec": "^1.5.5",
-    "@powerlines/core": "^0.43.30",
+    "@powerlines/core": "^0.44.0",
     "@storm-software/config": "^1.137.32",
     "@storm-software/config-tools": "^1.189.78",
     "@stryke/async": "^0.1.0",
@@ -180,5 +180,5 @@
     "typescript": "^6.0.3",
     "undici-types": "^7.25.0"
   },
-  "gitHead": "36f3385b33024e00aafb6c4a10e7a2e3c896aad5"
+  "gitHead": "0c0e8330c47e0ba315ba3367a13a51a576fd9811"
 }

package/dist/base-context-D8a2XGIK.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"base-context-D8a2XGIK.mjs","names":["#timestamp","#logLevel"],"sources":["../src/_internal/helpers/resolver.ts","../src/context/base-context.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { ResolvedConfig, Resolver } from \"@powerlines/core\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport defu from \"defu\";\nimport { JitiOptions, createJiti } from \"jiti\";\n\nexport type CreateResolverOptions = Omit<\n  JitiOptions,\n  \"fsCache\" | \"moduleCache\" | \"interopDefault\"\n> &\n  Pick<ResolvedConfig, \"mode\" | \"logLevel\" | \"skipCache\"> & {\n    workspaceRoot: string;\n    root: string;\n    cacheDir: string;\n  };\n\n/**\n * Create a Jiti resolver for the given workspace and project root.\n *\n * @param options - The options for creating the resolver.\n * @returns A Jiti instance configured for the specified workspace and project root.\n */\nfunction resolveOptions(options: CreateResolverOptions): JitiOptions {\n  return defu(options, {\n    interopDefault: true,\n    fsCache:\n      options.mode !== \"development\"\n        ? joinPaths(options.cacheDir, \"jiti\")\n        : false,\n    moduleCache: options.mode !== \"development\"\n  });\n}\n\n/**\n * Create a Jiti resolver for the given workspace and project root.\n *\n * @param options - The options for creating the resolver.\n * @returns A Jiti instance configured for the specified workspace and project root.\n */\nexport function createResolver(options: CreateResolverOptions): Resolver {\n  const baseResolver = createJiti(\n    joinPaths(options.workspaceRoot, options.root),\n    resolveOptions(options)\n  ) as Resolver;\n  baseResolver.plugin = createJiti(\n    joinPaths(options.workspaceRoot, options.root),\n    resolveOptions(options)\n  );\n\n  return baseResolver;\n}\n","/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type {\n  BaseContext,\n  EngineOptions,\n  LogFn,\n  Logger,\n  LogLevel,\n  ParsedUserConfig,\n  ResolvedEngineOptions,\n  Resolver\n} from \"@powerlines/core\";\nimport { loadUserConfigFile } from \"@powerlines/core/lib/config\";\nimport { createLog, extendLog } from \"@powerlines/core/lib/logger\";\nimport { LogLevelLabel } from \"@storm-software/config-tools/types\";\nimport { EnvPaths, getEnvPaths } from \"@stryke/env/get-env-paths\";\nimport { resolvePackage } from \"@stryke/fs/resolve\";\nimport { StormJSON } from \"@stryke/json/storm-json\";\nimport { isEqual } from \"@stryke/path/is-equal\";\nimport { isNull } from \"@stryke/type-checks/is-null\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport chalk from \"chalk\";\nimport { formatDistanceToNowStrict } from \"date-fns/formatDistanceToNowStrict\";\nimport defu from \"defu\";\nimport { UnpluginMessage } from \"unplugin\";\nimport { createResolver } from \"../_internal/helpers/resolver\";\n\nexport class PowerlinesBaseContext implements BaseContext {\n  #timestamp: number = Date.now();\n\n  #logLevel: LogLevel | null = \"info\";\n\n  /**\n   * The path to the Powerlines package\n   */\n  public powerlinesPath!: string;\n\n  /**\n   * The module resolver for the project\n   */\n  public resolver!: Resolver;\n\n  /**\n   * The options provided to the Powerlines process\n   */\n  public options!: ResolvedEngineOptions;\n\n  /**\n   * The input options used to initialize the context, which may be used when cloning the context to ensure the same configuration is applied to the new context\n   */\n  public inputOptions: Partial<EngineOptions> = {};\n\n  /**\n   * The parsed configuration file for the project\n   */\n  public configFile!: ParsedUserConfig;\n\n  /**\n   * A timestamp representing when the context was initialized\n   */\n  public get timestamp(): Date {\n    return new Date(this.#timestamp);\n  }\n\n  public get logLevel(): LogLevel | null {\n    return this.#logLevel || \"info\";\n  }\n\n  public set logLevel(level: LogLevel | null) {\n    this.#logLevel = level;\n  }\n\n  /**\n   * The logger function\n   */\n  public get log(): LogFn {\n    const level = this.logLevel || \"info\";\n    if (!this.logger || this.logger.level !== level) {\n      this.logger = {\n        log: this.createLog(),\n        level\n      };\n    }\n\n    return this.logger.log;\n  }\n\n  /**\n   * The environment paths for the project\n   */\n  public get envPaths(): EnvPaths {\n    return getEnvPaths({\n      orgId: this.options.organization,\n      appId: this.options.framework || \"powerlines\",\n      workspaceRoot: this.options.cwd\n    });\n  }\n\n  /**\n   * Creates a clone of the current context with the same configuration and workspace settings. This can be useful for running multiple builds in parallel or for creating isolated contexts for different parts of the build process.\n   *\n   * @remarks\n   * The cloned context will have the same configuration and workspace settings as the original context, but will have a different build ID, release ID, and timestamp. The virtual file system and caches will also be separate between the original and cloned contexts.\n   *\n   * @returns A promise that resolves to the cloned context.\n   */\n  public async clone(): Promise<BaseContext> {\n    const clone = new PowerlinesBaseContext();\n    await clone.init(this.options);\n\n    return clone;\n  }\n\n  /**\n   * A logging function for fatal messages\n   *\n   * @param message - The message to log.\n   */\n  public fatal(message: string | UnpluginMessage) {\n    this.log(\n      LogLevelLabel.FATAL,\n      isString(message) ? message : StormJSON.stringify(message)\n    );\n  }\n\n  /**\n   * A logging function for error messages\n   *\n   * @param message - The message to log.\n   */\n  public error(message: string | UnpluginMessage) {\n    this.log(\n      LogLevelLabel.ERROR,\n      isString(message) ? message : StormJSON.stringify(message)\n    );\n  }\n\n  /**\n   * A logging function for warning messages\n   *\n   * @param message - The message to log.\n   */\n  public warn(message: string | UnpluginMessage) {\n    this.log(\n      LogLevelLabel.WARN,\n      isString(message) ? message : StormJSON.stringify(message)\n    );\n  }\n\n  /**\n   * A logging function for informational messages\n   *\n   * @param message - The message to log.\n   */\n  public info(message: string | UnpluginMessage) {\n    this.log(\n      LogLevelLabel.INFO,\n      isString(message) ? message : StormJSON.stringify(message)\n    );\n  }\n\n  /**\n   * A logging function for debug messages\n   *\n   * @param message - The message to log.\n   */\n  public debug(message: string | UnpluginMessage) {\n    this.log(\n      LogLevelLabel.DEBUG,\n      isString(message) ? message : StormJSON.stringify(message)\n    );\n  }\n\n  /**\n   * A logging function for trace messages\n   *\n   * @param message - The message to log.\n   */\n  public trace(message: string | UnpluginMessage) {\n    this.log(\n      LogLevelLabel.TRACE,\n      isString(message) ? message : StormJSON.stringify(message)\n    );\n  }\n\n  /**\n   * A function to create a timer for measuring the duration of asynchronous operations\n   *\n   * @example\n   * ```ts\n   * const stopTimer = context.timer(\"Your Async Operation\");\n   * await performAsyncOperation();\n   * stopTimer(); // \"Your Async Operation completed in 123.45 milliseconds\"\n   * ```\n   *\n   * @param name - The name of the timer.\n   * @returns A function that, when called, stops the timer and logs the duration.\n   */\n  public timer(name: string): () => void {\n    const startDate = Date.now();\n    const startDuration = performance.now();\n\n    return () => {\n      const duration = performance.now() - startDuration;\n      this.log(\n        LogLevelLabel.PERFORMANCE,\n        `${chalk.bold.cyanBright(name)} completed in ${chalk.bold.cyanBright(\n          duration < 1000\n            ? `${duration.toFixed(2)} milliseconds`\n            : formatDistanceToNowStrict(startDate)\n        )}`\n      );\n    };\n  }\n\n  /**\n   * Create a new logger instance\n   *\n   * @param name - The name to use for the logger instance\n   * @returns A logger function\n   */\n  public createLog(name: string | null = null): LogFn {\n    return createLog(name, {\n      ...this.options,\n      logLevel: isNull(this.logLevel) ? \"silent\" : this.logLevel\n    });\n  }\n\n  /**\n   * Extend the current logger instance with a new name\n   *\n   * @param name - The name to use for the extended logger instance\n   * @returns A logger function\n   */\n  public extendLog(name: string): LogFn {\n    return extendLog(this.log, name);\n  }\n\n  /**\n   * A logger function specific to this context\n   */\n  protected logger!: Logger;\n\n  /**\n   * Initialize the context with the provided configuration options\n   *\n   * @remarks\n   * This method will set up the resolver and load the user configuration file based on the provided options. It is called during the construction of the context and can also be called when cloning the context to ensure that the new context has the same configuration and resolver setup.\n   *\n   * @param options - The configuration options to initialize the context with\n   */\n  protected async init(options: Partial<EngineOptions> = {}) {\n    this.inputOptions = options;\n\n    if (!this.powerlinesPath) {\n      const powerlinesPath = await resolvePackage(\"powerlines\");\n      if (!powerlinesPath) {\n        throw new Error(\"Could not resolve `powerlines` package location.\");\n      }\n      this.powerlinesPath = powerlinesPath;\n    }\n\n    const cwd = options.cwd || this.options?.cwd || process.cwd();\n    const root =\n      (options.root || this.options?.root) &&\n      (options.root || this.options.root).replace(/^\\.\\/?/, \"\") &&\n      !isEqual(options.root || this.options.root, cwd)\n        ? options.root || this.options.root\n        : \".\";\n\n    this.options = defu(\n      {\n        root,\n        cwd,\n        mode: options.mode,\n        framework: options.framework,\n        organization: options.organization,\n        configFile: options.configFile\n      },\n      this.options ?? {},\n      {\n        mode: \"production\",\n        framework: \"powerlines\"\n      }\n    ) as ResolvedEngineOptions;\n\n    this.resolver = createResolver({\n      workspaceRoot: cwd,\n      root,\n      cacheDir: this.envPaths.cache,\n      mode: this.options.mode,\n      logLevel: this.logLevel\n    });\n\n    this.configFile = await loadUserConfigFile(this.options, this.resolver);\n  }\n}\n"],"mappings":"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"}

package/dist/engine-context-DsA9XGVb.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"engine-context-DsA9XGVb.mjs","names":["#executions"],"sources":["../src/context/engine-context.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type {\n  EngineContext,\n  EngineOptions,\n  ResolvedExecutionOptions\n} from \"@powerlines/core\";\nimport { PowerlinesBaseContext } from \"./base-context\";\n\nexport class PowerlinesEngineContext\n  extends PowerlinesBaseContext\n  implements EngineContext\n{\n  #executions: ResolvedExecutionOptions[] = [];\n\n  /**\n   * Creates a new instance of the PowerlinesEngineContext class.\n   *\n   * @param options - The options to initialize the context with.\n   * @returns A promise that resolves to an instance of the PowerlinesEngineContext class.\n   */\n  public static async fromOptions(\n    options: EngineOptions\n  ): Promise<PowerlinesEngineContext> {\n    const context = new PowerlinesEngineContext();\n    await context.init(options);\n\n    if (!context.configFile?.config) {\n      context.fatal(\n        \"No configuration file found. Please ensure you have a valid configuration file in your project.\"\n      );\n      throw new Error(\"No configuration file found\");\n    }\n\n    if (Array.isArray(context.configFile.config)) {\n      context.#executions = await Promise.all(\n        context.configFile.config.map(async (_, configIndex) => ({\n          ...context.options,\n          configIndex\n        }))\n      );\n    } else {\n      context.#executions = [\n        {\n          ...context.options,\n          configIndex: 0\n        }\n      ];\n    }\n\n    return context;\n  }\n\n  /**\n   * A list of all command executions that will be run during the lifecycle of the engine\n   *\n   * @returns An array of ResolvedExecutionOptions representing each execution context for the engine.\n   */\n  public get executions(): ResolvedExecutionOptions[] {\n    return this.#executions;\n  }\n}\n"],"mappings":";;;AAyBA,IAAa,0BAAb,MAAa,gCACH,sBAEV;CACE,cAA0C,EAAE;;;;;;;CAQ5C,aAAoB,YAClB,SACkC;EAClC,MAAM,UAAU,IAAI,yBAAyB;AAC7C,QAAM,QAAQ,KAAK,QAAQ;AAE3B,MAAI,CAAC,QAAQ,YAAY,QAAQ;AAC/B,WAAQ,MACN,kGACD;AACD,SAAM,IAAI,MAAM,8BAA8B;;AAGhD,MAAI,MAAM,QAAQ,QAAQ,WAAW,OAAO,CAC1C,UAAQA,aAAc,MAAM,QAAQ,IAClC,QAAQ,WAAW,OAAO,IAAI,OAAO,GAAG,iBAAiB;GACvD,GAAG,QAAQ;GACX;GACD,EAAE,CACJ;MAED,UAAQA,aAAc,CACpB;GACE,GAAG,QAAQ;GACX,aAAa;GACd,CACF;AAGH,SAAO;;;;;;;CAQT,IAAW,aAAyC;AAClD,SAAO,MAAKA"}