@sapphire/pieces 4.2.3-pr-379.9f487c4.0 → 4.3.0

package/dist/esm/lib/strategies/env.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/strategies/env.ts"],"names":[],"mappings":";;;;;AAAA,SAAS,iBAAiB;AAE1B,SAAS,iBAAiB,MAAc;AACvC,SACC,QAAQ,SAAS,KAAK,CAAC,QAAQ,IAAI,SAAS,IAAI,CAAC;AAAA,EACjD,QAAQ,KAAK,KAAK,CAAC,QAAQ,IAAI,SAAS,IAAI,CAAC;AAE/C;AALS;AAOT,SAAS,oBAAoB,MAAc;AAC1C,SAAO,sBAAsB,WAAY,QAAQ,iBAA8B,SAAS,IAAI;AAC7F;AAFS;AAIT,SAAS,iBAAiB,MAAc,OAAgB;AACvD,SAAO,QAAQ,QAAQ,IAAI,IAAI,MAAM,QAAQ,CAAC,UAAU,QAAQ,IAAI,IAAI,CAAC;AAC1E;AAFS;AAqBF,IAAM;AAAA;AAAA;AAAA,EAGZ,QAAQ,IAAI,YAAY,MAAM;AAAA;AAAA,EAG9B,SAAS,QAAQ;AAAA;AAAA;AAAA,EAIjB,OAAO,IAAI,2BAA2B,KAAK;AAAA,EAE3C,iBAAiB,aAAa;AAAA,EAE9B,CAAC,UAAU,QAAQ,IAAI,WAAW;AAAA;AAAA,EAGlC,iBAAiB,YAAY;AAAA;AAAA,EAG7B,iBAAiB,UAAU,MAAM,KACjC,iBAAiB,kBAAkB;AAAA;AAAA,EAGnC,iBAAiB,gBAAgB;AAAA;AAAA,EAGjC,oBAAoB,eAAe;AAAA,EACnC,oBAAoB,oBAAoB,KACxC,iBAAiB,eAAe;AAAA;AAAA,EAGhC,oBAAoB,KAAK;AAAA;AAAA,EAGzB,oBAAoB,kBAAkB;AAAA;AAAA,EAGtC,oBAAoB,KAAK;AAAA","sourcesContent":["import { isNullish } from '@sapphire/utilities';\n\nfunction checkProcessArgv(name: string) {\n\treturn (\n\t\tprocess.execArgv.some((arg) => arg.includes(name)) || //\n\t\tprocess.argv.some((arg) => arg.includes(name))\n\t);\n}\n\nfunction checkPreloadModules(name: string) {\n\treturn '_preload_modules' in process && (process._preload_modules as string[]).includes(name);\n}\n\nfunction checkEnvVariable(name: string, value?: string) {\n\treturn value ? process.env[name] === value : !isNullish(process.env[name]);\n}\n\n/**\n * Whether or not the current environment can load TypeScript files. These\n * conditions are based on the most common tools and runtimes that support\n * loading TypeScript files directly.\n *\n * - {@linkplain https://www.npmjs.com/package/ts-node | `ts-node`}\n * - {@linkplain https://www.npmjs.com/package/ts-node-dev | `ts-node-dev`}\n * - {@linkplain https://www.npmjs.com/package/@babel/node | `@babel/node`}\n * - {@linkplain https://www.npmjs.com/package/vitest | `vitest`}\n * - {@linkplain https://www.npmjs.com/package/jest | `jest`}\n * - {@linkplain https://www.npmjs.com/package/@swc/cli | `swc`}\n * - {@linkplain https://www.npmjs.com/package/tsm | `tsm`}\n * - {@linkplain https://www.npmjs.com/package/esbuild | `esbuild`}\n * - {@linkplain https://www.npmjs.com/package/tsx | `tsx`}\n * - {@linkplain https://deno.com | `Deno`}\n * - {@linkplain https://bun.sh | `Bun`}\n */\nexport const CanLoadTypeScriptFiles: boolean =\n\t//\n\t// Deno\n\tReflect.has(globalThis, 'Deno') ||\n\t//\n\t// Bun\n\t'bun' in process.versions ||\n\t//\n\t// ts-node\n\t// > --require ts-node/register\n\tSymbol.for('ts-node.register.instance') in process ||\n\t// > --loader ts-node/esm\n\tcheckProcessArgv('ts-node/esm') ||\n\t// > ts-node-dev\n\t!isNullish(process.env.TS_NODE_DEV) ||\n\t//\n\t// @babel/node\n\tcheckProcessArgv('babel-node') ||\n\t//\n\t// vitest\n\tcheckEnvVariable('VITEST', 'true') ||\n\tcheckEnvVariable('VITEST_WORKER_ID') ||\n\t//\n\t// jest\n\tcheckEnvVariable('JEST_WORKER_ID') ||\n\t//\n\t// swc\n\tcheckPreloadModules('@swc/register') || //\n\tcheckPreloadModules('@swc-node/register') ||\n\tcheckProcessArgv('.bin/swc-node') ||\n\t//\n\t// tsm\n\tcheckPreloadModules('tsm') ||\n\t//\n\t// esbuild\n\tcheckPreloadModules('esbuild-register') ||\n\t//\n\t// tsx\n\tcheckPreloadModules('tsx');\n"]}

package/dist/esm/lib/structures/AliasPiece.mjs

@@ -1,4 +1,4 @@
-import { __name, __publicField } from '../../chunk-LIQV5WSN.mjs';
+import { __name, __publicField } from '../../chunk-KFLDEQ5J.mjs';
 import { Piece } from './Piece.mjs';
 
 var _AliasPiece = class _AliasPiece extends Piece {

package/dist/esm/lib/structures/AliasStore.mjs

@@ -1,4 +1,4 @@
-import { __name, __publicField } from '../../chunk-LIQV5WSN.mjs';
+import { __name, __publicField } from '../../chunk-KFLDEQ5J.mjs';
 import { Collection } from '@discordjs/collection';
 import { Store } from './Store.mjs';
 
@@ -33,8 +33,7 @@ var _AliasStore = class _AliasStore extends Store {
     const piece = this.resolve(name);
     for (const alias of piece.aliases) {
       const aliasPiece = this.aliases.get(alias);
-      if (aliasPiece === piece)
-        this.aliases.delete(alias);
+      if (aliasPiece === piece) this.aliases.delete(alias);
     }
     return super.unload(piece);
   }

package/dist/esm/lib/structures/AliasStore.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/structures/AliasStore.ts"],"names":[],"mappings":";;;;;;AAAA,SAAS,kBAAkB;AAE3B,SAAS,aAAa;AAMf,IAAM,cAAN,MAAM,oBAAgG,MAAoB;AAAA,EAA1H;AAAA;AAIN;AAAA;AAAA;AAAA,wBAAgB,WAAU,IAAI,WAAsB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMpC,IAAI,KAA4B;AAC/C,WAAO,MAAM,IAAI,GAAG,KAAK,KAAK,QAAQ,IAAI,GAAG;AAAA,EAC9C;AAAA;AAAA;AAAA;AAAA;AAAA,EAMgB,IAAI,KAAsB;AACzC,WAAO,MAAM,IAAI,GAAG,KAAK,KAAK,QAAQ,IAAI,GAAG;AAAA,EAC9C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOgB,OAAO,MAA8B;AACpD,UAAM,QAAQ,KAAK,QAAQ,IAAI;AAG/B,eAAW,SAAS,MAAM,SAAS;AAElC,YAAM,aAAa,KAAK,QAAQ,IAAI,KAAK;AACzC,UAAI,eAAe;AAAO,aAAK,QAAQ,OAAO,KAAK;AAAA,IACpD;AAEA,WAAO,MAAM,OAAO,KAAK;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAsB,OAAO,OAAU;AACtC,eAAW,OAAO,MAAM,SAAS;AAChC,WAAK,QAAQ,IAAI,KAAK,KAAK;AAAA,IAC5B;AAEA,WAAO,MAAM,OAAO,KAAK;AAAA,EAC1B;AACD;AApDiI;AAA1H,IAAM,aAAN","sourcesContent":["import { Collection } from '@discordjs/collection';\nimport type { AliasPiece } from './AliasPiece';\nimport { Store } from './Store';\nimport type { StoreRegistryKey } from './StoreRegistry';\n\n/**\n * The store class which contains {@link AliasPiece}s.\n */\nexport class AliasStore<T extends AliasPiece, StoreName extends StoreRegistryKey = StoreRegistryKey> extends Store<T, StoreName> {\n\t/**\n\t * The aliases referencing to pieces.\n\t */\n\tpublic readonly aliases = new Collection<string, T>();\n\n\t/**\n\t * Looks up the name by the store, falling back to an alias lookup.\n\t * @param key The key to look for.\n\t */\n\tpublic override get(key: string): T | undefined {\n\t\treturn super.get(key) ?? this.aliases.get(key);\n\t}\n\n\t/**\n\t * Checks whether a key is in the store, or is an alias\n\t * @param key The key to check\n\t */\n\tpublic override has(key: string): boolean {\n\t\treturn super.has(key) || this.aliases.has(key);\n\t}\n\n\t/**\n\t * Unloads a piece given its instance or its name, and removes all the aliases.\n\t * @param name The name of the file to load.\n\t * @return Returns the piece that was unloaded.\n\t */\n\tpublic override unload(name: string | T): Promise<T> {\n\t\tconst piece = this.resolve(name);\n\n\t\t// Unload all aliases for the given piece:\n\t\tfor (const alias of piece.aliases) {\n\t\t\t// We don't want to delete aliases that were overriden by another piece:\n\t\t\tconst aliasPiece = this.aliases.get(alias);\n\t\t\tif (aliasPiece === piece) this.aliases.delete(alias);\n\t\t}\n\n\t\treturn super.unload(piece);\n\t}\n\n\t/**\n\t * Inserts a piece into the store, and adds all the aliases.\n\t * @param piece The piece to be inserted into the store.\n\t * @return The inserted piece.\n\t */\n\tpublic override async insert(piece: T) {\n\t\tfor (const key of piece.aliases) {\n\t\t\tthis.aliases.set(key, piece);\n\t\t}\n\n\t\treturn super.insert(piece);\n\t}\n}\n"]}
+{"version":3,"sources":["../../../../src/lib/structures/AliasStore.ts"],"names":[],"mappings":";;;;;;AAAA,SAAS,kBAAkB;AAE3B,SAAS,aAAa;AAMf,IAAM,cAAN,MAAM,oBAAgG,MAAoB;AAAA,EAA1H;AAAA;AAIN;AAAA;AAAA;AAAA,wBAAgB,WAAU,IAAI,WAAsB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMpC,IAAI,KAA4B;AAC/C,WAAO,MAAM,IAAI,GAAG,KAAK,KAAK,QAAQ,IAAI,GAAG;AAAA,EAC9C;AAAA;AAAA;AAAA;AAAA;AAAA,EAMgB,IAAI,KAAsB;AACzC,WAAO,MAAM,IAAI,GAAG,KAAK,KAAK,QAAQ,IAAI,GAAG;AAAA,EAC9C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOgB,OAAO,MAA8B;AACpD,UAAM,QAAQ,KAAK,QAAQ,IAAI;AAG/B,eAAW,SAAS,MAAM,SAAS;AAElC,YAAM,aAAa,KAAK,QAAQ,IAAI,KAAK;AACzC,UAAI,eAAe,MAAO,MAAK,QAAQ,OAAO,KAAK;AAAA,IACpD;AAEA,WAAO,MAAM,OAAO,KAAK;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAsB,OAAO,OAAU;AACtC,eAAW,OAAO,MAAM,SAAS;AAChC,WAAK,QAAQ,IAAI,KAAK,KAAK;AAAA,IAC5B;AAEA,WAAO,MAAM,OAAO,KAAK;AAAA,EAC1B;AACD;AApDiI;AAA1H,IAAM,aAAN","sourcesContent":["import { Collection } from '@discordjs/collection';\nimport type { AliasPiece } from './AliasPiece';\nimport { Store } from './Store';\nimport type { StoreRegistryKey } from './StoreRegistry';\n\n/**\n * The store class which contains {@link AliasPiece}s.\n */\nexport class AliasStore<T extends AliasPiece, StoreName extends StoreRegistryKey = StoreRegistryKey> extends Store<T, StoreName> {\n\t/**\n\t * The aliases referencing to pieces.\n\t */\n\tpublic readonly aliases = new Collection<string, T>();\n\n\t/**\n\t * Looks up the name by the store, falling back to an alias lookup.\n\t * @param key The key to look for.\n\t */\n\tpublic override get(key: string): T | undefined {\n\t\treturn super.get(key) ?? this.aliases.get(key);\n\t}\n\n\t/**\n\t * Checks whether a key is in the store, or is an alias\n\t * @param key The key to check\n\t */\n\tpublic override has(key: string): boolean {\n\t\treturn super.has(key) || this.aliases.has(key);\n\t}\n\n\t/**\n\t * Unloads a piece given its instance or its name, and removes all the aliases.\n\t * @param name The name of the file to load.\n\t * @return Returns the piece that was unloaded.\n\t */\n\tpublic override unload(name: string | T): Promise<T> {\n\t\tconst piece = this.resolve(name);\n\n\t\t// Unload all aliases for the given piece:\n\t\tfor (const alias of piece.aliases) {\n\t\t\t// We don't want to delete aliases that were overriden by another piece:\n\t\t\tconst aliasPiece = this.aliases.get(alias);\n\t\t\tif (aliasPiece === piece) this.aliases.delete(alias);\n\t\t}\n\n\t\treturn super.unload(piece);\n\t}\n\n\t/**\n\t * Inserts a piece into the store, and adds all the aliases.\n\t * @param piece The piece to be inserted into the store.\n\t * @return The inserted piece.\n\t */\n\tpublic override async insert(piece: T) {\n\t\tfor (const key of piece.aliases) {\n\t\t\tthis.aliases.set(key, piece);\n\t\t}\n\n\t\treturn super.insert(piece);\n\t}\n}\n"]}

package/dist/esm/lib/structures/Piece.mjs

@@ -1,4 +1,4 @@
-import { __name, __publicField } from '../../chunk-LIQV5WSN.mjs';
+import { __name, __publicField } from '../../chunk-KFLDEQ5J.mjs';
 import { container } from '../shared/Container.mjs';
 import { PieceLocation } from './PieceLocation.mjs';
 

package/dist/esm/lib/structures/PieceLocation.mjs

@@ -1,4 +1,4 @@
-import { __name, __publicField } from '../../chunk-LIQV5WSN.mjs';
+import { __name, __publicField } from '../../chunk-KFLDEQ5J.mjs';
 import { relative, sep, basename } from 'path';
 import { VirtualPath } from '../internal/constants.mjs';
 

package/dist/esm/lib/structures/Store.mjs

@@ -1,4 +1,4 @@
-import { __name, __publicField, __privateAdd, __privateSet, __privateGet } from '../../chunk-LIQV5WSN.mjs';
+import { __name, __publicField, __privateAdd, __privateSet, __privateGet } from '../../chunk-KFLDEQ5J.mjs';
 import { Collection } from '@discordjs/collection';
 import { isClass, classExtends } from '@sapphire/utilities';
 import { join } from 'path';
@@ -10,8 +10,8 @@ import { LoaderStrategy } from '../strategies/LoaderStrategy.mjs';
 import { StoreRegistry } from './StoreRegistry.mjs';
 
 var defaultStrategy = new LoaderStrategy();
-var _a, _calledLoadAll, _walk;
-var _Store = class _Store extends Collection {
+var _a, _b, _calledLoadAll, _walk;
+var _Store = class _Store extends (_b = Collection, _a = ManuallyRegisteredPiecesSymbol, _b) {
   /**
    * @param constructor The piece constructor this store loads.
    * @param options The options for the store.
@@ -33,7 +33,7 @@ var _Store = class _Store extends Collection {
     /**
      * The walk function for the store.
      */
-    __privateAdd(this, _walk, void 0);
+    __privateAdd(this, _walk);
     this.Constructor = constructor;
     this.name = options.name;
     this.paths = new Set(options.paths ?? []);
@@ -203,12 +203,10 @@ var _Store = class _Store extends Collection {
   resolve(name) {
     if (typeof name === "string") {
       const result = this.get(name);
-      if (typeof result === "undefined")
-        throw new LoaderError(LoaderErrorType.UnloadedPiece, `The piece '${name}' does not exist.`);
+      if (typeof result === "undefined") throw new LoaderError(LoaderErrorType.UnloadedPiece, `The piece '${name}' does not exist.`);
       return result;
     }
-    if (name instanceof this.Constructor)
-      return name;
+    if (name instanceof this.Constructor) return name;
     throw new LoaderError(LoaderErrorType.IncorrectType, `The piece '${name.name}' is not an instance of '${this.Constructor.name}'.`);
   }
   /**
@@ -217,8 +215,7 @@ var _Store = class _Store extends Collection {
    * @return The inserted piece.
    */
   async insert(piece) {
-    if (!piece.enabled)
-      return piece;
+    if (!piece.enabled) return piece;
     this.strategy.onLoad(this, piece);
     await piece.onLoad();
     _Store.logger?.(`[STORE => ${this.name}] [INSERT] Loaded new piece '${piece.name}'.`);
@@ -279,7 +276,6 @@ var _Store = class _Store extends Collection {
     }
   }
 };
-_a = ManuallyRegisteredPiecesSymbol;
 _calledLoadAll = new WeakMap();
 _walk = new WeakMap();
 __name(_Store, "Store");

package/dist/esm/lib/structures/Store.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/structures/Store.ts"],"names":["Store"],"mappings":"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","sourcesContent":["import { Collection } from '@discordjs/collection';\nimport { classExtends, isClass, type AbstractConstructor, type Constructor } from '@sapphire/utilities';\nimport { join } from 'path';\nimport { LoaderError, LoaderErrorType } from '../errors/LoaderError';\nimport { resolvePath, type Path } from '../internal/Path';\nimport { ManuallyRegisteredPiecesSymbol, VirtualPath } from '../internal/constants';\nimport { container, type Container } from '../shared/Container';\nimport type { HydratedModuleData, ILoaderResultEntry, ILoaderStrategy, ModuleData } from '../strategies/ILoaderStrategy';\nimport { LoaderStrategy } from '../strategies/LoaderStrategy';\nimport type { Piece } from './Piece';\nimport { StoreRegistry, type StoreRegistryEntries, type StoreRegistryKey } from './StoreRegistry';\n\n/**\n * The options for the store, this features both hooks (changes the behaviour) and handlers (similar to event listeners).\n */\nexport interface StoreOptions<T extends Piece, StoreName extends StoreRegistryKey = StoreRegistryKey> {\n\t/**\n\t * The name for this store.\n\t */\n\treadonly name: StoreName;\n\n\t/**\n\t * The paths to load pieces from, should be absolute.\n\t * @default []\n\t */\n\treadonly paths?: readonly string[];\n\n\t/**\n\t * The strategy to be used for the loader.\n\t * @default Store.defaultStrategy\n\t */\n\treadonly strategy?: ILoaderStrategy<T>;\n}\n\n/**\n * An interface representing a logger function.\n */\nexport interface StoreLogger {\n\t/**\n\t * @param value The string to print. All strings will be formatted with the format `[STORE => ${name}] [${type}] ${content}`,\n\t * where the content may have identifiers (values or names of methods) surrounded by `'`. For example:\n\t *\n\t * - `[STORE => commands] [LOAD] Skipped piece '/home/user/bot/src/commands/foo.js' as 'LoaderStrategy#filter' returned 'null'.`\n\t * - `[STORE => commands] [INSERT] Unloaded new piece 'foo' due to 'enabled' being 'false'.`\n\t * - `[STORE => commands] [UNLOAD] Unloaded piece 'foo'.`\n\t */\n\t(value: string): void;\n}\n\nconst defaultStrategy = new LoaderStrategy();\n\n/**\n * The store class which contains {@link Piece}s.\n */\nexport class Store<T extends Piece, StoreName extends StoreRegistryKey = StoreRegistryKey> extends Collection<string, T> {\n\tpublic readonly Constructor: AbstractConstructor<T>;\n\tpublic readonly name: StoreName;\n\tpublic readonly paths: Set<string>;\n\tpublic readonly strategy: ILoaderStrategy<T>;\n\n\t/**\n\t * The queue of manually registered pieces to load.\n\t */\n\tprivate readonly [ManuallyRegisteredPiecesSymbol] = new Map<string, StoreManuallyRegisteredPiece<StoreName>>();\n\n\t/**\n\t * Whether or not the store has called `loadAll` at least once.\n\t */\n\t#calledLoadAll = false;\n\n\t/**\n\t * The walk function for the store.\n\t */\n\t#walk: LoaderStrategy<T>['walk'];\n\n\t/**\n\t * @param constructor The piece constructor this store loads.\n\t * @param options The options for the store.\n\t */\n\tpublic constructor(constructor: AbstractConstructor<T>, options: StoreOptions<T, StoreName>) {\n\t\tsuper();\n\t\tthis.Constructor = constructor;\n\t\tthis.name = options.name as StoreRegistryKey;\n\t\tthis.paths = new Set(options.paths ?? []);\n\t\tthis.strategy = options.strategy ?? Store.defaultStrategy;\n\n\t\tthis.#walk =\n\t\t\ttypeof this.strategy.walk === 'function' //\n\t\t\t\t? this.strategy.walk.bind(this.strategy)\n\t\t\t\t: defaultStrategy.walk.bind(defaultStrategy);\n\t}\n\n\t/**\n\t * A reference to the {@link Container} object for ease of use.\n\t * @see container\n\t */\n\tpublic get container(): Container {\n\t\treturn container;\n\t}\n\n\t/**\n\t * Registers a directory into the store.\n\t * @param path The path to be added.\n\t * @example\n\t * ```typescript\n\t * store\n\t *   .registerPath(resolve('commands'))\n\t *   .registerPath(resolve('third-party', 'commands'));\n\t * ```\n\t */\n\tpublic registerPath(path: Path): this {\n\t\tconst root = resolvePath(path);\n\n\t\tthis.paths.add(root);\n\t\tStore.logger?.(`[STORE => ${this.name}] [REGISTER] Registered path '${root}'.`);\n\t\treturn this;\n\t}\n\n\t/**\n\t * Adds a piece into the store's list of manually registered pieces. If {@linkcode Store.loadAll()} was called, the\n\t * piece will be loaded immediately, otherwise it will be queued until {@linkcode Store.loadAll()} is called.\n\t *\n\t * All manually registered pieces will be kept even after they are loaded to ensure they can be loaded again if\n\t * {@linkcode Store.loadAll()} is called again.\n\t *\n\t * @remarks\n\t *\n\t * - Pieces loaded this way will have their {@linkcode Piece.Context.root root} and\n\t *   {@linkcode Piece.Context.path path} set to {@linkcode VirtualPath}, and as such, cannot be reloaded.\n\t * - This method is useful in environments where file system access is limited or unavailable, such as when using\n\t *   {@link https://en.wikipedia.org/wiki/Serverless_computing Serverless Computing}.\n\t * - This method will always throw a {@link TypeError} if `entry.piece` is not a class.\n\t * - This method will always throw a {@linkcode LoaderError} if the piece does not extend the\n\t *   {@linkcode Store#Constructor store's piece constructor}.\n\t * - This operation is atomic, if any of the above errors are thrown, the piece will not be loaded.\n\t *\n\t * @seealso {@linkcode StoreRegistry.loadPiece()}\n\t * @since 3.8.0\n\t * @param entry The entry to load.\n\t * @example\n\t * ```typescript\n\t * import { container } from '@sapphire/pieces';\n\t *\n\t * class PingCommand extends Command {\n\t *   // ...\n\t * }\n\t *\n\t * container.stores.get('commands').loadPiece({\n\t *   name: 'ping',\n\t *   piece: PingCommand\n\t * });\n\t * ```\n\t */\n\tpublic async loadPiece(entry: StoreManuallyRegisteredPiece<StoreName>) {\n\t\tif (!isClass(entry.piece)) {\n\t\t\tthrow new TypeError(`The piece ${entry.name} is not a Class. ${String(entry.piece)}`);\n\t\t}\n\n\t\t// If the piece does not extend the store's Piece class, throw an error:\n\t\tif (!classExtends(entry.piece, this.Constructor as Constructor<T>)) {\n\t\t\tthrow new LoaderError(LoaderErrorType.IncorrectType, `The piece ${entry.name} does not extend ${this.name}`);\n\t\t}\n\n\t\tthis[ManuallyRegisteredPiecesSymbol].set(entry.name, entry);\n\t\tif (this.#calledLoadAll) {\n\t\t\tconst piece = this.construct(entry.piece as unknown as Constructor<T>, {\n\t\t\t\tname: entry.name,\n\t\t\t\troot: VirtualPath,\n\t\t\t\tpath: VirtualPath,\n\t\t\t\textension: VirtualPath\n\t\t\t});\n\t\t\tawait this.insert(piece);\n\t\t}\n\t}\n\n\t/**\n\t * Loads one or more pieces from a path.\n\t * @param root The root directory the file is from.\n\t * @param path The path of the file to load, relative to the `root`.\n\t * @return All the loaded pieces.\n\t */\n\tpublic async load(root: string, path: string): Promise<T[]> {\n\t\tif (root === VirtualPath) {\n\t\t\tthrow new LoaderError(LoaderErrorType.VirtualPiece, `Cannot load a virtual file.`);\n\t\t}\n\n\t\tconst full = join(root, path);\n\t\tconst data = this.strategy.filter(full);\n\t\tif (data === null) {\n\t\t\tStore.logger?.(`[STORE => ${this.name}] [LOAD] Skipped piece '${full}' as 'LoaderStrategy#filter' returned 'null'.`);\n\t\t\treturn [];\n\t\t}\n\n\t\tconst promises: Promise<T>[] = [];\n\t\tconst finishedData = this.hydrateModuleData(root, data);\n\t\tfor await (const Ctor of this.strategy.load(this, finishedData)) {\n\t\t\tpromises.push(this.insert(this.construct(Ctor, finishedData)));\n\t\t}\n\n\t\treturn Promise.all(promises);\n\t}\n\n\t/**\n\t * Unloads a piece given its instance or its name.\n\t * @param name The name of the file to load.\n\t * @return Returns the piece that was unloaded.\n\t */\n\tpublic async unload(name: string | T): Promise<T> {\n\t\tconst piece = this.resolve(name);\n\n\t\t// Unload piece:\n\t\tthis.strategy.onUnload(this, piece);\n\t\tawait piece.onUnload();\n\t\tStore.logger?.(`[STORE => ${this.name}] [UNLOAD] Unloaded piece '${piece.name}'.`);\n\n\t\t// Remove from cache and return it:\n\t\tthis.delete(piece.name);\n\t\tStore.logger?.(`[STORE => ${this.name}] [UNLOAD] Removed piece '${piece.name}'.`);\n\t\treturn piece;\n\t}\n\n\t/**\n\t * Unloads all pieces from the store.\n\t */\n\tpublic async unloadAll(): Promise<T[]> {\n\t\tconst promises: Promise<T>[] = [];\n\t\tfor (const piece of this.values()) {\n\t\t\tpromises.push(this.unload(piece));\n\t\t}\n\n\t\tconst results = await Promise.all(promises);\n\n\t\tthis.strategy.onUnloadAll(this);\n\t\tStore.logger?.(`[STORE => ${this.name}] [UNLOAD-ALL] Removed all pieces.`);\n\t\treturn results;\n\t}\n\n\t/**\n\t * Loads all pieces from all directories specified by {@link paths}.\n\t */\n\tpublic async loadAll(): Promise<void> {\n\t\tthis.#calledLoadAll = true;\n\n\t\tconst pieces: T[] = [];\n\t\tfor (const entry of this[ManuallyRegisteredPiecesSymbol].values()) {\n\t\t\tconst piece = this.construct(entry.piece as unknown as Constructor<T>, {\n\t\t\t\tname: entry.name,\n\t\t\t\troot: VirtualPath,\n\t\t\t\tpath: VirtualPath,\n\t\t\t\textension: VirtualPath\n\t\t\t});\n\t\t\tpieces.push(piece);\n\t\t}\n\n\t\tfor (const path of this.paths) {\n\t\t\tfor await (const piece of this.loadPath(path)) {\n\t\t\t\tpieces.push(piece);\n\t\t\t}\n\t\t}\n\n\t\tStore.logger?.(`[STORE => ${this.name}] [LOAD-ALL] Found '${pieces.length}' pieces.`);\n\n\t\t// Clear the store before inserting the new pieces:\n\t\tawait this.unloadAll();\n\t\tStore.logger?.(`[STORE => ${this.name}] [LOAD-ALL] Cleared all pieces.`);\n\n\t\t// Load each piece:\n\t\tfor (const piece of pieces) {\n\t\t\tawait this.insert(piece);\n\t\t}\n\n\t\t// Call onLoadAll:\n\t\tthis.strategy.onLoadAll(this);\n\t\tStore.logger?.(`[STORE => ${this.name}] [LOAD-ALL] Successfully loaded '${this.size}' pieces.`);\n\t}\n\n\t/**\n\t * Resolves a piece by its name or its instance.\n\t * @param name The name of the piece or the instance itself.\n\t * @return The resolved piece.\n\t */\n\tpublic resolve(name: string | T): T {\n\t\tif (typeof name === 'string') {\n\t\t\tconst result = this.get(name);\n\t\t\tif (typeof result === 'undefined') throw new LoaderError(LoaderErrorType.UnloadedPiece, `The piece '${name}' does not exist.`);\n\t\t\treturn result;\n\t\t}\n\n\t\tif (name instanceof this.Constructor) return name;\n\t\tthrow new LoaderError(LoaderErrorType.IncorrectType, `The piece '${name.name}' is not an instance of '${this.Constructor.name}'.`);\n\t}\n\n\t/**\n\t * Inserts a piece into the store.\n\t * @param piece The piece to be inserted into the store.\n\t * @return The inserted piece.\n\t */\n\tpublic async insert(piece: T): Promise<T> {\n\t\tif (!piece.enabled) return piece;\n\n\t\t// Load piece:\n\t\tthis.strategy.onLoad(this, piece);\n\t\tawait piece.onLoad();\n\t\tStore.logger?.(`[STORE => ${this.name}] [INSERT] Loaded new piece '${piece.name}'.`);\n\n\t\t// If the onLoad disabled the piece, call unload and return it:\n\t\tif (!piece.enabled) {\n\t\t\t// Unload piece:\n\t\t\tthis.strategy.onUnload(this, piece);\n\t\t\tawait piece.onUnload();\n\t\t\tStore.logger?.(`[STORE => ${this.name}] [INSERT] Unloaded new piece '${piece.name}' due to 'enabled' being 'false'.`);\n\n\t\t\treturn piece;\n\t\t}\n\n\t\t// Unload existing piece, if any:\n\t\tconst previous = super.get(piece.name);\n\t\tif (previous) {\n\t\t\tawait this.unload(previous);\n\t\t\tStore.logger?.(`[STORE => ${this.name}] [INSERT] Unloaded existing piece '${piece.name}' due to conflicting 'name'.`);\n\t\t}\n\n\t\t// Set the new piece and return it:\n\t\tthis.set(piece.name, piece);\n\t\tStore.logger?.(`[STORE => ${this.name}] [INSERT] Inserted new piece '${piece.name}'.`);\n\t\treturn piece;\n\t}\n\n\t/**\n\t * Constructs a {@link Piece} instance.\n\t * @param Ctor The {@link Piece}'s constructor used to build the instance.\n\t * @param data The module's information\n\t * @return An instance of the constructed piece.\n\t */\n\tpublic construct(Ctor: ILoaderResultEntry<T>, data: HydratedModuleData): T {\n\t\treturn new Ctor({ store: this, root: data.root, path: data.path, name: data.name }, { name: data.name, enabled: true });\n\t}\n\n\t/**\n\t * Adds the final module data properties.\n\t * @param root The root directory to add.\n\t * @param data The module data returned from {@link ILoaderStrategy.filter}.\n\t * @returns The finished module data.\n\t */\n\tprivate hydrateModuleData(root: string, data: ModuleData): HydratedModuleData {\n\t\treturn { root, ...data };\n\t}\n\n\t/**\n\t * Loads a directory into the store.\n\t * @param root The directory to load the pieces from.\n\t * @return An async iterator that yields the pieces to be loaded into the store.\n\t */\n\tprivate async *loadPath(root: string): AsyncIterableIterator<T> {\n\t\tStore.logger?.(`[STORE => ${this.name}] [WALK] Loading all pieces from '${root}'.`);\n\t\tfor await (const child of this.#walk(this, root, Store.logger)) {\n\t\t\tconst data = this.strategy.filter(child);\n\t\t\tif (data === null) {\n\t\t\t\tStore.logger?.(`[STORE => ${this.name}] [LOAD] Skipped piece '${child}' as 'LoaderStrategy#filter' returned 'null'.`);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tconst finishedData = this.hydrateModuleData(root, data);\n\t\t\t\tfor await (const Ctor of this.strategy.load(this, finishedData)) {\n\t\t\t\t\tyield this.construct(Ctor, finishedData);\n\t\t\t\t}\n\t\t\t} catch (error) {\n\t\t\t\tthis.strategy.onError(error as Error, data.path);\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * The default strategy, defaults to {@link LoaderStrategy}, which is constructed on demand when a store is constructed,\n\t * when none was set beforehand.\n\t */\n\tpublic static defaultStrategy: ILoaderStrategy<any> = defaultStrategy;\n\n\t/**\n\t * The default logger, defaults to `null`.\n\t */\n\tpublic static logger: StoreLogger | null = null;\n}\n\n/**\n * An entry for a manually registered piece using {@linkcode Store.loadPiece()}.\n * @since 3.8.0\n */\nexport interface StoreManuallyRegisteredPiece<StoreName extends StoreRegistryKey> {\n\tname: string;\n\tpiece: StoreRegistryEntries[StoreName] extends Store<infer Piece> ? Constructor<Piece> : never;\n}\n\nexport namespace Store {\n\texport const Registry = StoreRegistry;\n\texport type Options<T extends Piece> = StoreOptions<T>;\n\texport type Logger = StoreLogger;\n\texport type RegistryEntries = StoreRegistryEntries;\n}\n"]}
+{"version":3,"sources":["../../../../src/lib/structures/Store.ts"],"names":["Store"],"mappings":"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","sourcesContent":["import { Collection } from '@discordjs/collection';\nimport { classExtends, isClass, type AbstractConstructor, type Constructor } from '@sapphire/utilities';\nimport { join } from 'path';\nimport { LoaderError, LoaderErrorType } from '../errors/LoaderError';\nimport { resolvePath, type Path } from '../internal/Path';\nimport { ManuallyRegisteredPiecesSymbol, VirtualPath } from '../internal/constants';\nimport { container, type Container } from '../shared/Container';\nimport type { HydratedModuleData, ILoaderResultEntry, ILoaderStrategy, ModuleData } from '../strategies/ILoaderStrategy';\nimport { LoaderStrategy } from '../strategies/LoaderStrategy';\nimport type { Piece } from './Piece';\nimport { StoreRegistry, type StoreRegistryEntries, type StoreRegistryKey } from './StoreRegistry';\n\n/**\n * The options for the store, this features both hooks (changes the behaviour) and handlers (similar to event listeners).\n */\nexport interface StoreOptions<T extends Piece, StoreName extends StoreRegistryKey = StoreRegistryKey> {\n\t/**\n\t * The name for this store.\n\t */\n\treadonly name: StoreName;\n\n\t/**\n\t * The paths to load pieces from, should be absolute.\n\t * @default []\n\t */\n\treadonly paths?: readonly string[];\n\n\t/**\n\t * The strategy to be used for the loader.\n\t * @default Store.defaultStrategy\n\t */\n\treadonly strategy?: ILoaderStrategy<T>;\n}\n\n/**\n * An interface representing a logger function.\n */\nexport interface StoreLogger {\n\t/**\n\t * @param value The string to print. All strings will be formatted with the format `[STORE => ${name}] [${type}] ${content}`,\n\t * where the content may have identifiers (values or names of methods) surrounded by `'`. For example:\n\t *\n\t * - `[STORE => commands] [LOAD] Skipped piece '/home/user/bot/src/commands/foo.js' as 'LoaderStrategy#filter' returned 'null'.`\n\t * - `[STORE => commands] [INSERT] Unloaded new piece 'foo' due to 'enabled' being 'false'.`\n\t * - `[STORE => commands] [UNLOAD] Unloaded piece 'foo'.`\n\t */\n\t(value: string): void;\n}\n\nconst defaultStrategy = new LoaderStrategy();\n\n/**\n * The store class which contains {@link Piece}s.\n */\nexport class Store<T extends Piece, StoreName extends StoreRegistryKey = StoreRegistryKey> extends Collection<string, T> {\n\tpublic readonly Constructor: AbstractConstructor<T>;\n\tpublic readonly name: StoreName;\n\tpublic readonly paths: Set<string>;\n\tpublic readonly strategy: ILoaderStrategy<T>;\n\n\t/**\n\t * The queue of manually registered pieces to load.\n\t */\n\tprivate readonly [ManuallyRegisteredPiecesSymbol] = new Map<string, StoreManuallyRegisteredPiece<StoreName>>();\n\n\t/**\n\t * Whether or not the store has called `loadAll` at least once.\n\t */\n\t#calledLoadAll = false;\n\n\t/**\n\t * The walk function for the store.\n\t */\n\t#walk: LoaderStrategy<T>['walk'];\n\n\t/**\n\t * @param constructor The piece constructor this store loads.\n\t * @param options The options for the store.\n\t */\n\tpublic constructor(constructor: AbstractConstructor<T>, options: StoreOptions<T, StoreName>) {\n\t\tsuper();\n\t\tthis.Constructor = constructor;\n\t\tthis.name = options.name as StoreRegistryKey;\n\t\tthis.paths = new Set(options.paths ?? []);\n\t\tthis.strategy = options.strategy ?? Store.defaultStrategy;\n\n\t\tthis.#walk =\n\t\t\ttypeof this.strategy.walk === 'function' //\n\t\t\t\t? this.strategy.walk.bind(this.strategy)\n\t\t\t\t: defaultStrategy.walk.bind(defaultStrategy);\n\t}\n\n\t/**\n\t * A reference to the {@link Container} object for ease of use.\n\t * @see container\n\t */\n\tpublic get container(): Container {\n\t\treturn container;\n\t}\n\n\t/**\n\t * Registers a directory into the store.\n\t * @param path The path to be added.\n\t * @example\n\t * ```typescript\n\t * store\n\t *   .registerPath(resolve('commands'))\n\t *   .registerPath(resolve('third-party', 'commands'));\n\t * ```\n\t */\n\tpublic registerPath(path: Path): this {\n\t\tconst root = resolvePath(path);\n\n\t\tthis.paths.add(root);\n\t\tStore.logger?.(`[STORE => ${this.name}] [REGISTER] Registered path '${root}'.`);\n\t\treturn this;\n\t}\n\n\t/**\n\t * Adds a piece into the store's list of manually registered pieces. If {@linkcode Store.loadAll()} was called, the\n\t * piece will be loaded immediately, otherwise it will be queued until {@linkcode Store.loadAll()} is called.\n\t *\n\t * All manually registered pieces will be kept even after they are loaded to ensure they can be loaded again if\n\t * {@linkcode Store.loadAll()} is called again.\n\t *\n\t * @remarks\n\t *\n\t * - Pieces loaded this way will have their {@linkcode Piece.Context.root root} and\n\t *   {@linkcode Piece.Context.path path} set to {@linkcode VirtualPath}, and as such, cannot be reloaded.\n\t * - This method is useful in environments where file system access is limited or unavailable, such as when using\n\t *   {@link https://en.wikipedia.org/wiki/Serverless_computing Serverless Computing}.\n\t * - This method will always throw a {@link TypeError} if `entry.piece` is not a class.\n\t * - This method will always throw a {@linkcode LoaderError} if the piece does not extend the\n\t *   {@linkcode Store#Constructor store's piece constructor}.\n\t * - This operation is atomic, if any of the above errors are thrown, the piece will not be loaded.\n\t *\n\t * @seealso {@linkcode StoreRegistry.loadPiece()}\n\t * @since 3.8.0\n\t * @param entry The entry to load.\n\t * @example\n\t * ```typescript\n\t * import { container } from '@sapphire/pieces';\n\t *\n\t * class PingCommand extends Command {\n\t *   // ...\n\t * }\n\t *\n\t * container.stores.get('commands').loadPiece({\n\t *   name: 'ping',\n\t *   piece: PingCommand\n\t * });\n\t * ```\n\t */\n\tpublic async loadPiece(entry: StoreManuallyRegisteredPiece<StoreName>) {\n\t\tif (!isClass(entry.piece)) {\n\t\t\tthrow new TypeError(`The piece ${entry.name} is not a Class. ${String(entry.piece)}`);\n\t\t}\n\n\t\t// If the piece does not extend the store's Piece class, throw an error:\n\t\tif (!classExtends(entry.piece, this.Constructor as Constructor<T>)) {\n\t\t\tthrow new LoaderError(LoaderErrorType.IncorrectType, `The piece ${entry.name} does not extend ${this.name}`);\n\t\t}\n\n\t\tthis[ManuallyRegisteredPiecesSymbol].set(entry.name, entry);\n\t\tif (this.#calledLoadAll) {\n\t\t\tconst piece = this.construct(entry.piece as unknown as Constructor<T>, {\n\t\t\t\tname: entry.name,\n\t\t\t\troot: VirtualPath,\n\t\t\t\tpath: VirtualPath,\n\t\t\t\textension: VirtualPath\n\t\t\t});\n\t\t\tawait this.insert(piece);\n\t\t}\n\t}\n\n\t/**\n\t * Loads one or more pieces from a path.\n\t * @param root The root directory the file is from.\n\t * @param path The path of the file to load, relative to the `root`.\n\t * @return All the loaded pieces.\n\t */\n\tpublic async load(root: string, path: string): Promise<T[]> {\n\t\tif (root === VirtualPath) {\n\t\t\tthrow new LoaderError(LoaderErrorType.VirtualPiece, `Cannot load a virtual file.`);\n\t\t}\n\n\t\tconst full = join(root, path);\n\t\tconst data = this.strategy.filter(full);\n\t\tif (data === null) {\n\t\t\tStore.logger?.(`[STORE => ${this.name}] [LOAD] Skipped piece '${full}' as 'LoaderStrategy#filter' returned 'null'.`);\n\t\t\treturn [];\n\t\t}\n\n\t\tconst promises: Promise<T>[] = [];\n\t\tconst finishedData = this.hydrateModuleData(root, data);\n\t\tfor await (const Ctor of this.strategy.load(this, finishedData)) {\n\t\t\tpromises.push(this.insert(this.construct(Ctor, finishedData)));\n\t\t}\n\n\t\treturn Promise.all(promises);\n\t}\n\n\t/**\n\t * Unloads a piece given its instance or its name.\n\t * @param name The name of the file to load.\n\t * @return Returns the piece that was unloaded.\n\t */\n\tpublic async unload(name: string | T): Promise<T> {\n\t\tconst piece = this.resolve(name);\n\n\t\t// Unload piece:\n\t\tthis.strategy.onUnload(this, piece);\n\t\tawait piece.onUnload();\n\t\tStore.logger?.(`[STORE => ${this.name}] [UNLOAD] Unloaded piece '${piece.name}'.`);\n\n\t\t// Remove from cache and return it:\n\t\tthis.delete(piece.name);\n\t\tStore.logger?.(`[STORE => ${this.name}] [UNLOAD] Removed piece '${piece.name}'.`);\n\t\treturn piece;\n\t}\n\n\t/**\n\t * Unloads all pieces from the store.\n\t */\n\tpublic async unloadAll(): Promise<T[]> {\n\t\tconst promises: Promise<T>[] = [];\n\t\tfor (const piece of this.values()) {\n\t\t\tpromises.push(this.unload(piece));\n\t\t}\n\n\t\tconst results = await Promise.all(promises);\n\n\t\tthis.strategy.onUnloadAll(this);\n\t\tStore.logger?.(`[STORE => ${this.name}] [UNLOAD-ALL] Removed all pieces.`);\n\t\treturn results;\n\t}\n\n\t/**\n\t * Loads all pieces from all directories specified by {@link paths}.\n\t */\n\tpublic async loadAll(): Promise<void> {\n\t\tthis.#calledLoadAll = true;\n\n\t\tconst pieces: T[] = [];\n\t\tfor (const entry of this[ManuallyRegisteredPiecesSymbol].values()) {\n\t\t\tconst piece = this.construct(entry.piece as unknown as Constructor<T>, {\n\t\t\t\tname: entry.name,\n\t\t\t\troot: VirtualPath,\n\t\t\t\tpath: VirtualPath,\n\t\t\t\textension: VirtualPath\n\t\t\t});\n\t\t\tpieces.push(piece);\n\t\t}\n\n\t\tfor (const path of this.paths) {\n\t\t\tfor await (const piece of this.loadPath(path)) {\n\t\t\t\tpieces.push(piece);\n\t\t\t}\n\t\t}\n\n\t\tStore.logger?.(`[STORE => ${this.name}] [LOAD-ALL] Found '${pieces.length}' pieces.`);\n\n\t\t// Clear the store before inserting the new pieces:\n\t\tawait this.unloadAll();\n\t\tStore.logger?.(`[STORE => ${this.name}] [LOAD-ALL] Cleared all pieces.`);\n\n\t\t// Load each piece:\n\t\tfor (const piece of pieces) {\n\t\t\tawait this.insert(piece);\n\t\t}\n\n\t\t// Call onLoadAll:\n\t\tthis.strategy.onLoadAll(this);\n\t\tStore.logger?.(`[STORE => ${this.name}] [LOAD-ALL] Successfully loaded '${this.size}' pieces.`);\n\t}\n\n\t/**\n\t * Resolves a piece by its name or its instance.\n\t * @param name The name of the piece or the instance itself.\n\t * @return The resolved piece.\n\t */\n\tpublic resolve(name: string | T): T {\n\t\tif (typeof name === 'string') {\n\t\t\tconst result = this.get(name);\n\t\t\tif (typeof result === 'undefined') throw new LoaderError(LoaderErrorType.UnloadedPiece, `The piece '${name}' does not exist.`);\n\t\t\treturn result;\n\t\t}\n\n\t\tif (name instanceof this.Constructor) return name;\n\t\tthrow new LoaderError(LoaderErrorType.IncorrectType, `The piece '${name.name}' is not an instance of '${this.Constructor.name}'.`);\n\t}\n\n\t/**\n\t * Inserts a piece into the store.\n\t * @param piece The piece to be inserted into the store.\n\t * @return The inserted piece.\n\t */\n\tpublic async insert(piece: T): Promise<T> {\n\t\tif (!piece.enabled) return piece;\n\n\t\t// Load piece:\n\t\tthis.strategy.onLoad(this, piece);\n\t\tawait piece.onLoad();\n\t\tStore.logger?.(`[STORE => ${this.name}] [INSERT] Loaded new piece '${piece.name}'.`);\n\n\t\t// If the onLoad disabled the piece, call unload and return it:\n\t\tif (!piece.enabled) {\n\t\t\t// Unload piece:\n\t\t\tthis.strategy.onUnload(this, piece);\n\t\t\tawait piece.onUnload();\n\t\t\tStore.logger?.(`[STORE => ${this.name}] [INSERT] Unloaded new piece '${piece.name}' due to 'enabled' being 'false'.`);\n\n\t\t\treturn piece;\n\t\t}\n\n\t\t// Unload existing piece, if any:\n\t\tconst previous = super.get(piece.name);\n\t\tif (previous) {\n\t\t\tawait this.unload(previous);\n\t\t\tStore.logger?.(`[STORE => ${this.name}] [INSERT] Unloaded existing piece '${piece.name}' due to conflicting 'name'.`);\n\t\t}\n\n\t\t// Set the new piece and return it:\n\t\tthis.set(piece.name, piece);\n\t\tStore.logger?.(`[STORE => ${this.name}] [INSERT] Inserted new piece '${piece.name}'.`);\n\t\treturn piece;\n\t}\n\n\t/**\n\t * Constructs a {@link Piece} instance.\n\t * @param Ctor The {@link Piece}'s constructor used to build the instance.\n\t * @param data The module's information\n\t * @return An instance of the constructed piece.\n\t */\n\tpublic construct(Ctor: ILoaderResultEntry<T>, data: HydratedModuleData): T {\n\t\treturn new Ctor({ store: this, root: data.root, path: data.path, name: data.name }, { name: data.name, enabled: true });\n\t}\n\n\t/**\n\t * Adds the final module data properties.\n\t * @param root The root directory to add.\n\t * @param data The module data returned from {@link ILoaderStrategy.filter}.\n\t * @returns The finished module data.\n\t */\n\tprivate hydrateModuleData(root: string, data: ModuleData): HydratedModuleData {\n\t\treturn { root, ...data };\n\t}\n\n\t/**\n\t * Loads a directory into the store.\n\t * @param root The directory to load the pieces from.\n\t * @return An async iterator that yields the pieces to be loaded into the store.\n\t */\n\tprivate async *loadPath(root: string): AsyncIterableIterator<T> {\n\t\tStore.logger?.(`[STORE => ${this.name}] [WALK] Loading all pieces from '${root}'.`);\n\t\tfor await (const child of this.#walk(this, root, Store.logger)) {\n\t\t\tconst data = this.strategy.filter(child);\n\t\t\tif (data === null) {\n\t\t\t\tStore.logger?.(`[STORE => ${this.name}] [LOAD] Skipped piece '${child}' as 'LoaderStrategy#filter' returned 'null'.`);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tconst finishedData = this.hydrateModuleData(root, data);\n\t\t\t\tfor await (const Ctor of this.strategy.load(this, finishedData)) {\n\t\t\t\t\tyield this.construct(Ctor, finishedData);\n\t\t\t\t}\n\t\t\t} catch (error) {\n\t\t\t\tthis.strategy.onError(error as Error, data.path);\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * The default strategy, defaults to {@link LoaderStrategy}, which is constructed on demand when a store is constructed,\n\t * when none was set beforehand.\n\t */\n\tpublic static defaultStrategy: ILoaderStrategy<any> = defaultStrategy;\n\n\t/**\n\t * The default logger, defaults to `null`.\n\t */\n\tpublic static logger: StoreLogger | null = null;\n}\n\n/**\n * An entry for a manually registered piece using {@linkcode Store.loadPiece()}.\n * @since 3.8.0\n */\nexport interface StoreManuallyRegisteredPiece<StoreName extends StoreRegistryKey> {\n\tname: string;\n\tpiece: StoreRegistryEntries[StoreName] extends Store<infer Piece> ? Constructor<Piece> : never;\n}\n\nexport namespace Store {\n\texport const Registry = StoreRegistry;\n\texport type Options<T extends Piece> = StoreOptions<T>;\n\texport type Logger = StoreLogger;\n\texport type RegistryEntries = StoreRegistryEntries;\n}\n"]}

package/dist/esm/lib/structures/StoreRegistry.mjs

@@ -1,4 +1,4 @@
-import { __name, __privateAdd, __privateGet } from '../../chunk-LIQV5WSN.mjs';
+import { __name, __privateAdd, __privateGet } from '../../chunk-KFLDEQ5J.mjs';
 import { Collection } from '@discordjs/collection';
 import { isClass } from '@sapphire/utilities';
 import { join } from 'path';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sapphire/pieces",
-  "version": "4.2.3-pr-379.9f487c4.0",
+  "version": "4.3.0",
   "description": "Sapphire's piece loader.",
   "main": "dist/cjs/index.cjs",
   "module": "dist/esm/index.mjs",
@@ -35,35 +35,35 @@
   },
   "dependencies": {
     "@discordjs/collection": "^1.5.3",
-    "@sapphire/utilities": "^3.15.3",
-    "tslib": "^2.6.2"
+    "@sapphire/utilities": "^3.16.2",
+    "tslib": "^2.6.3"
   },
   "devDependencies": {
-    "@commitlint/cli": "^18.4.4",
-    "@commitlint/config-conventional": "^18.4.4",
-    "@favware/cliff-jumper": "^2.2.3",
+    "@commitlint/cli": "^19.3.0",
+    "@commitlint/config-conventional": "^19.2.2",
+    "@favware/cliff-jumper": "^4.0.2",
     "@favware/npm-deprecate": "^1.0.7",
     "@favware/rollup-type-bundler": "^3.3.0",
-    "@sapphire/eslint-config": "^5.0.3",
+    "@sapphire/eslint-config": "^5.0.5",
     "@sapphire/prettier-config": "^2.0.0",
-    "@sapphire/ts-config": "^5.0.0",
-    "@types/node": "^20.11.5",
-    "@typescript-eslint/eslint-plugin": "^6.19.0",
-    "@typescript-eslint/parser": "^6.19.0",
+    "@sapphire/ts-config": "^5.0.1",
+    "@types/node": "^20.14.9",
+    "@typescript-eslint/eslint-plugin": "^7.13.1",
+    "@typescript-eslint/parser": "^7.13.1",
     "concurrently": "^8.2.2",
     "cz-conventional-changelog": "^3.3.0",
-    "esbuild-plugin-file-path-extensions": "^2.0.0",
-    "eslint": "^8.56.0",
+    "esbuild-plugin-file-path-extensions": "^2.1.2",
+    "eslint": "^8.57.0",
     "eslint-config-prettier": "^9.1.0",
     "eslint-plugin-prettier": "^5.1.3",
-    "lint-staged": "^15.2.0",
-    "prettier": "^3.2.4",
-    "rimraf": "^5.0.5",
-    "tsup": "^8.0.1",
-    "typedoc": "^0.25.7",
-    "typedoc-json-parser": "^9.0.1",
-    "typescript": "^5.3.3",
-    "vitest": "^1.2.1"
+    "lint-staged": "^15.2.7",
+    "prettier": "^3.3.2",
+    "rimraf": "^5.0.7",
+    "tsup": "^8.1.0",
+    "typedoc": "^0.26.1",
+    "typedoc-json-parser": "^10.0.0",
+    "typescript": "^5.5.2",
+    "vitest": "^1.6.0"
   },
   "repository": {
     "type": "git",
@@ -107,10 +107,10 @@
     "access": "public"
   },
   "resolutions": {
-    "acorn": "^8.11.3",
+    "acorn": "^8.12.0",
     "ansi-regex": "^5.0.1",
     "minimist": "^1.2.8"
   },
   "prettier": "@sapphire/prettier-config",
-  "packageManager": "yarn@4.0.2"
+  "packageManager": "yarn@4.3.1"
 }

package/dist/esm/chunk-LIQV5WSN.mjs

@@ -1,36 +0,0 @@
-var __defProp = Object.defineProperty;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined")
-    return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-var __publicField = (obj, key, value) => {
-  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-  return value;
-};
-var __accessCheck = (obj, member, msg) => {
-  if (!member.has(obj))
-    throw TypeError("Cannot " + msg);
-};
-var __privateGet = (obj, member, getter) => {
-  __accessCheck(obj, member, "read from private field");
-  return getter ? getter.call(obj) : member.get(obj);
-};
-var __privateAdd = (obj, member, value) => {
-  if (member.has(obj))
-    throw TypeError("Cannot add the same private member more than once");
-  member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
-};
-var __privateSet = (obj, member, value, setter) => {
-  __accessCheck(obj, member, "write to private field");
-  setter ? setter.call(obj, value) : member.set(obj, value);
-  return value;
-};
-
-export { __name, __privateAdd, __privateGet, __privateSet, __publicField, __require };
-//# sourceMappingURL=out.js.map
-//# sourceMappingURL=chunk-LIQV5WSN.mjs.map