@sv443-network/coreutils 2.0.1 → 2.0.3

package/dist/lib/DataStore.d.ts

@@ -2,8 +2,8 @@
  * @module DataStore  
  * This module contains the DataStore class, which is a general purpose, sync and async persistent database for JSON-serializable data - [see the documentation for more info](https://github.com/Sv443-Network/CoreUtils/blob/main/docs.md#class-datastore)  
  */
-import type { DataStoreEngine } from "./DataStoreEngine.js";
-import type { LooseUnion, Prettify, SerializableVal } from "./types.js";
+import type { DataStoreEngine } from "./DataStoreEngine.ts";
+import type { LooseUnion, Prettify, SerializableVal } from "./types.ts";
 /** Function that takes the data in the old format and returns the data in the new format. Also supports an asynchronous migration. */
 type MigrationFunc = (oldData: any) => any | Promise<any>;
 /** Dictionary of format version numbers and the function that migrates to them from the previous whole integer */

package/dist/lib/DataStoreEngine.d.ts

@@ -3,8 +3,8 @@
  * This module contains the `DataStoreEngine` class and some of its subclasses like `FileStorageEngine` and `BrowserStorageEngine`.  
  * [See the documentation for more info.](https://github.com/Sv443-Network/CoreUtils/blob/main/docs.md#class-datastoreengine)  
  */
-import type { DataStoreData, DataStoreOptions } from "./DataStore.js";
-import type { Prettify, SerializableVal } from "./types.js";
+import type { DataStoreData, DataStoreOptions } from "./DataStore.ts";
+import type { Prettify, SerializableVal } from "./types.ts";
 /** Contains the only properties of {@linkcode DataStoreOptions} that are relevant to the {@linkcode DataStoreEngine} class. */
 export type DataStoreEngineDSOptions<TData extends DataStoreData> = Prettify<Pick<DataStoreOptions<TData>, "decodeData" | "encodeData" | "id">>;
 export interface DataStoreEngine<TData extends DataStoreData> {
@@ -20,7 +20,7 @@ export declare abstract class DataStoreEngine<TData extends DataStoreData> {
     constructor(options?: DataStoreEngineDSOptions<TData>);
     /** Called by DataStore on creation, to pass its options. Only call this if you are using this instance standalone! */
     setDataStoreOptions(dataStoreOptions: DataStoreEngineDSOptions<TData>): void;
-    /** Fetches a value from persistent storage */
+    /** Fetches a value from persistent storage. Defaults to `defaultValue` if the value does not exist. `null` is considered a valid value. */
     abstract getValue<TValue extends SerializableVal = string>(name: string, defaultValue: TValue): Promise<string | TValue>;
     /** Sets a value in persistent storage */
     abstract setValue(name: string, value: SerializableVal): Promise<void>;
@@ -88,6 +88,7 @@ export type FileStorageEngineOptions = {
  */
 export declare class FileStorageEngine<TData extends DataStoreData> extends DataStoreEngine<TData> {
     protected options: FileStorageEngineOptions & Required<Pick<FileStorageEngineOptions, "filePath">>;
+    private fileAccessQueue;
     /**
      * Creates an instance of `FileStorageEngine`.  
      *  

package/dist/lib/DataStoreSerializer.d.ts

@@ -2,7 +2,7 @@
  * @module DataStoreSerializer  
  * This module contains the DataStoreSerializer class, which allows you to import and export serialized DataStore data - [see the documentation for more info](https://github.com/Sv443-Network/UserUtils/blob/main/docs.md#datastoreserializer)  
  */
-import type { DataStore, DataStoreData } from "./DataStore.js";
+import type { DataStore, DataStoreData } from "./DataStore.ts";
 /** Options for the DataStoreSerializer class */
 export type DataStoreSerializerOptions = {
     /** Whether to add a checksum to the exported data. Defaults to `true` */

package/dist/lib/Debouncer.d.ts

@@ -2,7 +2,7 @@
  * @module Debouncer  
  * This module contains the Debouncer class and debounce function that allow you to reduce the amount of calls in rapidly firing event listeners and such - [see the documentation for more info](https://github.com/Sv443-Network/UserUtils/blob/main/docs.md#debouncer)  
  */
-import { NanoEmitter } from "./NanoEmitter.js";
+import { NanoEmitter } from "./NanoEmitter.ts";
 /**
  * The type of edge to use for the debouncer - [see the docs for a diagram and explanation.](https://github.com/Sv443-Network/UserUtils/blob/main/docs.md#debouncer)  
  * - `immediate` - (default & recommended) - calls the listeners at the very first call ("rising" edge) and queues the latest call until the timeout expires  

package/dist/lib/NanoEmitter.d.ts

@@ -3,7 +3,7 @@
  * This module contains the NanoEmitter class, which is a tiny event emitter powered by [nanoevents](https://www.npmjs.com/package/nanoevents) - [see the documentation for more info](https://github.com/Sv443-Network/UserUtils/blob/main/docs.md#nanoemitter)  
  */
 import { type DefaultEvents, type Emitter, type EventsMap, type Unsubscribe } from "nanoevents";
-import type { Prettify } from "./types.js";
+import type { Prettify } from "./types.ts";
 export interface NanoEmitterOptions {
     /** If set to true, allows emitting events through the public method emit() */
     publicEmit: boolean;

package/dist/lib/TestDataStore.d.ts

@@ -0,0 +1,12 @@
+import { DataStore, type DataStoreData } from "./DataStore.ts";
+import type { SerializableVal } from "./types.ts";
+/**
+ * A DataStore wrapper subclass that exposes internal methods for testing via the `direct_` prefixed methods.  
+ */
+export declare class TestDataStore<TData extends DataStoreData> extends DataStore<TData> {
+    direct_getValue<TValue extends SerializableVal = string>(name: string, defaultValue: TValue): Promise<string | TValue>;
+    direct_setValue(name: string, value: SerializableVal): Promise<void>;
+    direct_renameKey(oldName: string, newName: string): Promise<void>;
+    direct_deleteValue(name: string): Promise<void>;
+    direct_setFirstInit(value: boolean): void;
+}

package/dist/lib/TieredCache.d.ts

@@ -2,10 +2,10 @@
  * @module TieredCache  
  * This module contains the TieredCache class, which is a cache that can have multiple tiers with different max TTLs, with data being moved between tiers based on what is fetched the most.  
  */
-import { DataStore, type DataStoreData } from "./DataStore.js";
-import { NanoEmitter, type NanoEmitterOptions } from "./NanoEmitter.js";
-import type { DataStoreEngine } from "./DataStoreEngine.js";
-import type { Prettify } from "./types.js";
+import { DataStore, type DataStoreData } from "./DataStore.ts";
+import { NanoEmitter, type NanoEmitterOptions } from "./NanoEmitter.ts";
+import type { DataStoreEngine } from "./DataStoreEngine.ts";
+import type { Prettify } from "./types.ts";
 /** Options for the {@linkcode TieredCache} class. */
 export type TieredCacheOptions<TData extends DataStoreData> = Prettify<{
     /** Unique identifier for this cache. */

package/dist/lib/Translate.d.ts

@@ -2,7 +2,7 @@
  * @module Translate  
  * This module contains a sophisticated but still lightweight, JSON-based translation system - [see the documentation for more info](https://github.com/Sv443-Network/CoreUtils/blob/main/docs.md#class-translate)  
  */
-import type { Stringifiable } from "./types.js";
+import type { Stringifiable } from "./types.ts";
 /**
  * Translation object to pass to {@linkcode tr.addTranslations()}  
  * Can be a flat object of identifier keys and the translation text as the value, or an infinitely nestable object containing the same.  

package/dist/lib/crypto.d.ts

@@ -2,7 +2,7 @@
  * @module crypto  
  * This module contains various cryptographic functions, like compression and Uint8Array encoding - [see the documentation for more info](https://github.com/Sv443-Network/CoreUtils/blob/main/docs.md#crypto)  
  */
-import type { Stringifiable } from "./types.js";
+import type { Stringifiable } from "./types.ts";
 /** Converts an Uint8Array to a base64-encoded (ASCII) string */
 export declare function abtoa(buf: Uint8Array): string;
 /** Converts a base64-encoded (ASCII) string to an Uint8Array representation of its bytes */

package/dist/lib/index.d.ts

@@ -2,16 +2,16 @@
  * @module @sv443-network/coreutils  
  * @description Cross-platform, general-purpose, JavaScript core library for Node, Deno and the browser. Intended to be used in conjunction with [`@sv443-network/userutils`](https://github.com/Sv443-Network/UserUtils) and [`@sv443-network/djsutils`](https://github.com/Sv443-Network/DJSUtils), but can be used independently as well.  
  */
-export * from "./array.js";
-export * from "./colors.js";
-export * from "./crypto.js";
-export * from "./math.js";
-export * from "./misc.js";
-export * from "./text.js";
-export * from "./types.js";
-export * from "./DataStore.js";
-export * from "./DataStoreEngine.js";
-export * from "./DataStoreSerializer.js";
-export * from "./Debouncer.js";
-export * from "./Errors.js";
-export * from "./NanoEmitter.js";
+export * from "./array.ts";
+export * from "./colors.ts";
+export * from "./crypto.ts";
+export * from "./math.ts";
+export * from "./misc.ts";
+export * from "./text.ts";
+export * from "./types.ts";
+export * from "./DataStore.ts";
+export * from "./DataStoreEngine.ts";
+export * from "./DataStoreSerializer.ts";
+export * from "./Debouncer.ts";
+export * from "./Errors.ts";
+export * from "./NanoEmitter.ts";

package/dist/lib/math.d.ts

@@ -2,7 +2,7 @@
  * @module math  
  * This module contains general-purpose math functions like clamping, mapping and random number generation - [see the documentation for more info](https://github.com/Sv443-Network/CoreUtils/blob/main/docs.md#math)  
  */
-import type { NumberFormat, Stringifiable } from "./types.js";
+import type { NumberFormat, Stringifiable } from "./types.ts";
 /** Checks if the given {@linkcode bitSet} contains the given {@linkcode checkVal} */
 export declare function bitSetHas<TType extends number | bigint>(bitSet: TType, checkVal: TType): boolean;
 /** Ensures the passed {@linkcode value} always stays between {@linkcode min} and {@linkcode max} */

package/dist/lib/misc.d.ts

@@ -2,7 +2,7 @@
  * @module misc  
  * This module contains miscellaneous functions that don't fit in another category - [see the documentation for more info](https://github.com/Sv443-Network/UserUtils/blob/main/docs.md#misc)  
  */
-import type { ListLike, Prettify, Stringifiable } from "./types.js";
+import type { ListLike, Prettify, Stringifiable } from "./types.ts";
 /**
  * A ValueGen value is either its type, a promise that resolves to its type, or a function that returns its type, either synchronous or asynchronous.  
  * ValueGen allows for the utmost flexibility when applied to any type, as long as {@linkcode consumeGen()} is used to get the final value.  

package/dist/lib/text.d.ts

@@ -1,4 +1,4 @@
-import type { ListLike, Prettify, Stringifiable } from "./types.js";
+import type { ListLike, Prettify, Stringifiable } from "./types.ts";
 /**
  * Automatically pluralizes the given string an `-s` or `-ies` to the passed {@linkcode term}, if {@linkcode num} is not equal to 1.  
  * By default, words ending in `-y` will have it replaced with `-ies`, and all other words will simply have `-s` appended.  

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sv443-network/coreutils",
   "libName": "@sv443-network/coreutils",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "Cross-platform, general-purpose, JavaScript core library for Node, Deno and the browser. Intended to be used in conjunction with `@sv443-network/userutils` and `@sv443-network/djsutils`, but can be used independently as well.",
   "main": "dist/CoreUtils.cjs",
   "module": "dist/CoreUtils.mjs",
@@ -41,27 +41,27 @@
     "nanoevents": "^9.1.0"
   },
   "devDependencies": {
-    "@changesets/cli": "^2.29.4",
-    "@eslint/eslintrc": "^3.3.1",
-    "@eslint/js": "^9.28.0",
-    "@swc/core": "^1.11.29",
-    "@testing-library/dom": "^10.4.0",
-    "@types/deno": "^2.3.0",
-    "@types/node": "^22.15.29",
+    "@changesets/cli": "^2.29.8",
+    "@eslint/eslintrc": "^3.3.3",
+    "@eslint/js": "^9.39.2",
+    "@swc/core": "^1.15.11",
+    "@testing-library/dom": "^10.4.1",
+    "@types/deno": "^2.5.0",
+    "@types/node": "^22.19.7",
     "@types/tx2": "^1.0.3",
-    "@typescript-eslint/eslint-plugin": "^8.33.0",
-    "@typescript-eslint/parser": "^8.33.0",
-    "@typescript-eslint/utils": "^8.33.0",
-    "@vitest/coverage-v8": "^3.1.4",
+    "@typescript-eslint/eslint-plugin": "^8.54.0",
+    "@typescript-eslint/parser": "^8.54.0",
+    "@typescript-eslint/utils": "^8.54.0",
+    "@vitest/coverage-v8": "^3.2.4",
     "esbuild-plugin-umd-wrapper": "^3.0.0",
-    "eslint": "^9.28.0",
-    "globals": "^16.2.0",
+    "eslint": "^9.39.2",
+    "globals": "^16.5.0",
     "jsdom": "^26.1.0",
     "tslib": "^2.8.1",
-    "tsup": "^8.5.0",
-    "tsx": "^4.19.4",
-    "typescript": "^5.8.3",
-    "vitest": "^3.1.4"
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
   },
   "files": [
     "/dist/CoreUtils.cjs",