powerlines 0.36.20 → 0.36.22

package/dist/lib/chunk-Y5KONJVR.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/lib/fs/storage/base.ts"],"names":["BaseStorageAdapter","options","base","resolve","isReadOnly","exists","key","existsSync","get","getSync","set","value","setSync","mkdirSync","_","mkdir","dirPath","Promise","remove","removeSync","clearSync","keys","listSync","length","map","startsWith","joinPaths","clear","list","all","isDirectorySync","isDirectory","isFileSync","isFile","dispose","Symbol","asyncDispose","_dispose","test","Error","name","JSON","stringify","appendPath","correctPath","replace"],"mappings":"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","file":"chunk-Y5KONJVR.cjs","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 { 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\";\nimport { StorageAdapter } from \"../../../types/fs\";\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   * Constructor for the BaseStorageAdapter.\n   *\n   * @param options - Configuration options for the storage adapter.\n   */\n  public constructor(options: TOptions = { base: \"/\" } as TOptions) {\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.options.isReadOnly) {\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.options.isReadOnly) {\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.options.isReadOnly) {\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.options.isReadOnly) {\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   * 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 = this.options.base) {\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"]}

package/dist/lib/chunk-YJEZASNU.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/lib/fs/storage/file-system.ts"],"names":["FileSystemStorageAdapter","BaseStorageAdapter","name","options","existsSync","key","resolve","exists","getSync","readFileSync","get","readFile","setSync","value","isReadOnly","writeFileSync","set","writeFile","removeSync","unlinkSync","err","ignoreNotfound","remove","unlink","catch","mkdirSync","dirPath","createDirectorySync","mkdir","createDirectory","listSync","base","listFilesSync","ignore","list","listFiles","then","r","isDirectorySync","isDirectory","isFileSync","isFile"],"mappings":";;;;;;;;;;;;AAmCO,IAAMA,wBAAAA,GAAN,cAAuCC,kBAAAA,CAAAA;EAnC9C;;;;;;EAuCSC,IAAAA,GAAO,aAAA;;;;;;AAOd,EAAA,WAAA,CAAmBC,OAAAA,EAAiC;AAClD,IAAA,KAAA,CAAMA,OAAAA,CAAAA;AACR,EAAA;;;;;;;AAQOC,EAAAA,UAAAA,CAAWC,GAAAA,EAAsB;AACtC,IAAA,OAAOD,UAAAA,CAAW,IAAA,CAAKE,OAAAA,CAAQD,GAAAA,CAAAA,CAAAA;AACjC,EAAA;;;;;;;AAQA,EAAA,MAAsBE,OAAOF,GAAAA,EAA+B;AAC1D,IAAA,OAAOE,MAAAA,CAAO,IAAA,CAAKD,OAAAA,CAAQD,GAAAA,CAAAA,CAAAA;AAC7B,EAAA;;;;;;;AAQOG,EAAAA,OAAAA,CAAQH,GAAAA,EAA4B;AACzC,IAAA,OAAOI,YAAAA,CAAa,IAAA,CAAKH,OAAAA,CAAQD,GAAAA,CAAAA,CAAAA;AACnC,EAAA;;;;;;;AAQA,EAAA,MAAsBK,IAAIL,GAAAA,EAAqC;AAC7D,IAAA,OAAOM,QAAAA,CAAS,IAAA,CAAKL,OAAAA,CAAQD,GAAAA,CAAAA,CAAAA;AAC/B,EAAA;;;;;;;AAQOO,EAAAA,OAAAA,CAAQP,KAAaQ,KAAAA,EAAe;AACzC,IAAA,IAAI,CAAC,IAAA,CAAKV,OAAAA,CAAQW,UAAAA,EAAY;AAC5B,MAAA,OAAOC,aAAAA,CAAc,IAAA,CAAKT,OAAAA,CAAQD,GAAAA,GAAMQ,KAAAA,CAAAA;AAC1C,IAAA;AACF,EAAA;;;;;;;EAQA,MAAsBG,GAAAA,CAAIX,KAAaQ,KAAAA,EAA8B;AACnE,IAAA,IAAI,CAAC,IAAA,CAAKV,OAAAA,CAAQW,UAAAA,EAAY;AAC5B,MAAA,OAAOG,SAAAA,CAAU,IAAA,CAAKX,OAAAA,CAAQD,GAAAA,GAAMQ,KAAAA,CAAAA;AACtC,IAAA;AACF,EAAA;;;;;;AAOOK,EAAAA,UAAAA,CAAWb,GAAAA,EAAa;AAC7B,IAAA,IAAI,CAAC,IAAA,CAAKF,OAAAA,CAAQW,UAAAA,EAAY;AAC5B,MAAA,IAAI;AACF,QAAA,OAAOK,UAAAA,CAAW,IAAA,CAAKb,OAAAA,CAAQD,GAAAA,CAAAA,CAAAA;AACjC,MAAA,CAAA,CAAA,OAASe,GAAAA,EAAK;AACZ,QAAA,OAAOC,eAAeD,GAAAA,CAAAA;AACxB,MAAA;AACF,IAAA;AACF,EAAA;;;;;;AAOA,EAAA,MAAsBE,OAAOjB,GAAAA,EAA4B;AACvD,IAAA,IAAI,CAAC,IAAA,CAAKF,OAAAA,CAAQW,UAAAA,EAAY;AAC5B,MAAA,OAAOS,OAAO,IAAA,CAAKjB,OAAAA,CAAQD,GAAAA,CAAAA,CAAAA,CAAMmB,MAAMH,cAAAA,CAAAA;AACzC,IAAA;AACF,EAAA;;;;;;AAOgBI,EAAAA,SAAAA,CAAUC,OAAAA,EAAiB;AACzCC,IAAAA,mBAAAA,CAAoB,IAAA,CAAKrB,OAAAA,CAAQoB,OAAAA,CAAAA,CAAAA;AACnC,EAAA;;;;;;AAOA,EAAA,MAAsBE,MAAMF,OAAAA,EAAgC;AAC1D,IAAA,MAAMG,eAAAA,CAAgB,IAAA,CAAKvB,OAAAA,CAAQoB,OAAAA,CAAAA,CAAAA;AACrC,EAAA;;;;;;;AAQOI,EAAAA,QAAAA,CAASC,IAAAA,EAAyB;AACvC,IAAA,IAAI;AACF,MAAA,OAAOC,aAAAA,CAAc,IAAA,CAAK1B,OAAAA,CAAQyB,IAAAA,CAAAA,EAAO;AACvCE,QAAAA,MAAAA,EAAQ,KAAK9B,OAAAA,CAAQ8B;OACvB,CAAA;AACF,IAAA,CAAA,CAAA,OAASb,GAAAA,EAAK;AACZ,MAAA,OAAOC,cAAAA,CAAeD,GAAAA,CAAAA,IAAQ,EAAA;AAChC,IAAA;AACF,EAAA;;;;;;;AAQA,EAAA,MAAsBc,KAAKH,IAAAA,EAAkC;AAC3D,IAAA,OAAOI,SAAAA,CAAU,IAAA,CAAK7B,OAAAA,CAAQyB,IAAAA,CAAAA,EAAO;AACnCE,MAAAA,MAAAA,EAAQ,KAAK9B,OAAAA,CAAQ8B;KACvB,CAAA,CACGT,MAAMH,cAAAA,CAAAA,CACNe,KAAKC,CAAAA,CAAAA,KAAKA,CAAAA,IAAK,EAAE,CAAA;AACtB,EAAA;;;;;;;AAQgBC,EAAAA,eAAAA,CAAgBjC,GAAAA,EAAsB;AACpD,IAAA,OAAOkC,WAAAA,CAAY,IAAA,CAAKjC,OAAAA,CAAQD,GAAAA,CAAAA,CAAAA;AAClC,EAAA;;;;;;;AAQgBmC,EAAAA,UAAAA,CAAWnC,GAAAA,EAAsB;AAC/C,IAAA,OAAO,CAACoC,MAAAA,CAAO,IAAA,CAAKnC,OAAAA,CAAQD,GAAAA,CAAAA,CAAAA;AAC9B,EAAA;AACF","file":"chunk-YJEZASNU.js","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 { 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 { unlinkSync } from \"node:fs\";\nimport { unlink } from \"node:fs/promises\";\nimport { ignoreNotfound } from \"../helpers\";\nimport { BaseStorageAdapter, StorageAdapterOptions } from \"./base\";\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   * Constructor for the FileSystemStorageAdapter.\n   *\n   * @param options - Configuration options for the storage adapter.\n   */\n  public constructor(options?: StorageAdapterOptions) {\n    super(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.options.isReadOnly) {\n      return writeFileSync(this.resolve(key), value);\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.options.isReadOnly) {\n      return writeFile(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.options.isReadOnly) {\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.options.isReadOnly) {\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"]}