@nsnanocat/util 2.2.4 → 2.3.0

package/README.md

@@ -5,7 +5,7 @@
 核心目标：
 - 统一不同平台的 HTTP、通知、持久化、结束脚本等调用方式。
 - 在一个脚本里尽量少写平台分支。
-- 提供一组可直接复用的 polyfill（`fetch` / `Storage` / `Console` / `Lodash`）。
+- 提供一组可直接复用的 polyfill（`fetch` / `Storage` / `KV` / `Console` / `Lodash`）。
 
 ## 目录
 - [安装与导入](#安装与导入)
@@ -65,6 +65,7 @@ import {
   wait,       // 延时等待工具（Promise）
   Console,    // 统一日志工具（支持 logLevel）
   Lodash as _, // Lodash 建议按官方示例惯例使用 `_` 作为工具对象别名
+  KV,         // Cloudflare Workers KV 异步适配器（显式传入 namespace binding）
   Storage,    // 统一持久化存储接口（适配 $prefs / $persistentStore / 内存 / 文件）
 } from "@nsnanocat/util";
 ```
@@ -80,6 +81,7 @@ import {
 - `lib/wait.mjs`
 - `polyfill/Console.mjs`
 - `polyfill/fetch.mjs`
+- `polyfill/KV.mjs`
 - `polyfill/Lodash.mjs`
 - `polyfill/StatusTexts.mjs`
 - `polyfill/Storage.mjs`
@@ -106,6 +108,7 @@ import {
 | `getStorage.mjs` | `lib/argument.mjs`, `polyfill/Console.mjs`, `polyfill/Lodash.mjs`, `polyfill/Storage.mjs` | `Console.debug`, `Console.logLevel`, `Lodash.merge`, `Storage.getItem` | 先标准化 `$argument`，再合并默认配置/持久化配置/运行参数 |
 | `polyfill/Console.mjs` | `lib/app.mjs` | `$app` | 日志在 Worker / Node.js 与 iOS 脚本环境使用不同错误输出策略 |
 | `polyfill/fetch.mjs` | `lib/app.mjs`, `polyfill/Lodash.mjs`, `polyfill/StatusTexts.mjs`, `polyfill/Console.mjs` | `$app`, `Lodash.set`, `StatusTexts`（`Console` 当前版本未实际调用） | 按平台选请求引擎并做参数映射、响应结构统一 |
+| `polyfill/KV.mjs` | `lib/app.mjs`, `polyfill/Lodash.mjs`, `polyfill/Storage.mjs` | `$app`, `Lodash.get`, `Lodash.set`, `Lodash.unset`, `Storage` | 为 Cloudflare Workers KV 提供异步适配，并在非 Worker 平台回退到 `Storage` |
 | `polyfill/Storage.mjs` | `lib/app.mjs`, `polyfill/Lodash.mjs` | `$app`, `Lodash.get`, `Lodash.set`, `Lodash.unset` | 按平台选持久化后端并支持 `@key.path` 读写 |
 | `polyfill/Lodash.mjs` | 无 | 无 | 提供路径/合并等基础能力，被多个模块复用 |
 | `polyfill/StatusTexts.mjs` | 无 | 无 | 提供 HTTP 状态文案，供 `fetch/done` 使用 |
@@ -471,6 +474,39 @@ const store = getStorage("@my_box", ["YouTube", "Global"], database);
 | Worker | 进程内内存缓存 |
 | Node.js | 本地 `box.dat` |
 
+### `polyfill/KV.mjs`
+
+`KV` 是面向 Cloudflare Workers KV 的异步适配器：
+- 调用方显式传入 namespace binding：`new KV(env.NAMESPACE)`
+- Worker 分支直接调用 `namespace.get/put/delete/list`
+- `get()` 不传 `type`，默认按 Cloudflare 行为读取字符串
+- 非 Worker 平台会回退到 `Storage.getItem/setItem/removeItem`
+- `list()` 仅支持 Worker，返回 Cloudflare KV 原生列举结果
+- `clear()` 始终返回 `false`
+
+#### `new KV(namespace)`
+- `namespace` 需提供 `get(key)` / `put(key, value)` / `delete(key)`。
+
+#### `await kv.getItem(keyName, defaultValue = null)`
+- 支持普通 key。
+- 支持路径 key：`@root.path.to.key`。
+- 读取后会尝试 `JSON.parse`。
+
+#### `await kv.setItem(keyName, keyValue)`
+- 支持普通 key 与路径 key。
+- `keyValue` 为对象时自动 `JSON.stringify`。
+
+#### `await kv.removeItem(keyName)`
+- 支持普通 key 与路径 key。
+
+#### `await kv.list(options = {})`
+- 仅支持 Worker。
+- 透传 `prefix` / `limit` / `cursor` 到 `namespace.list(options)`。
+- 返回 Cloudflare KV 的原生结果：`keys` / `list_complete` / `cursor`。
+
+#### `await kv.clear()`
+- 始终返回 `false`。
+
 ### `polyfill/Console.mjs`
 
 `Console` 是统一日志工具（静态类）。

package/index.js

@@ -6,6 +6,7 @@ export * from "./lib/time.mjs";
 export * from "./lib/wait.mjs";
 export * from "./polyfill/Console.mjs";
 export * from "./polyfill/fetch.mjs";
+export * from "./polyfill/KV.mjs";
 export * from "./polyfill/Lodash.mjs";
 export * from "./polyfill/StatusTexts.mjs";
 export * from "./polyfill/Storage.mjs";

package/package.json

@@ -42,5 +42,5 @@
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
-  "version": "2.2.4"
+  "version": "2.3.0"
 }

package/polyfill/KV.mjs

@@ -0,0 +1,240 @@
+import { $app } from "../lib/app.mjs";
+import { Lodash as _ } from "./Lodash.mjs";
+import { Storage } from "./Storage.mjs";
+
+/**
+ * Cloudflare Workers KV 异步适配器。
+ * Async adapter for Cloudflare Workers KV.
+ *
+ * 设计目标:
+ * Design goal:
+ * - 提供与 `Storage` 接近的异步接口
+ * - Provide an async API close to `Storage`
+ * - 在 Worker 中使用显式传入的 KV namespace binding
+ * - Use an explicitly passed KV namespace binding in Workers
+ * - 在非 Worker 平台回退到 `Storage`
+ * - Fall back to `Storage` on non-Worker platforms
+ *
+ * 支持路径键:
+ * Supports path key:
+ * - `@root.path.to.value`
+ *
+ * @link https://developers.cloudflare.com/kv/get-started/#5-access-your-kv-namespace-from-your-worker
+ * @link https://developers.cloudflare.com/kv/api/read-key-value-pairs/
+ * @link https://developers.cloudflare.com/kv/api/write-key-value-pairs/
+ * @link https://developers.cloudflare.com/kv/api/delete-key-value-pairs/
+ * @link https://developers.cloudflare.com/kv/api/list-keys/
+ */
+export class KV {
+	/**
+	 * `@key.path` 解析正则。
+	 * Regex for `@key.path` parsing.
+	 *
+	 * @type {RegExp}
+	 */
+	static #nameRegex = /^@(?<key>[^.]+)(?:\.(?<path>.*))?$/;
+
+	/**
+	 * Cloudflare KV namespace 绑定。
+	 * Cloudflare KV namespace binding.
+	 *
+	 * @type {{ get(key: string): Promise<string|null>; put(key: string, value: string): Promise<void>; delete(key: string): Promise<void>; list?(options?: { prefix?: string; limit?: number; cursor?: string }): Promise<{ keys: { name: string; expiration?: number; metadata?: object }[]; list_complete: boolean; cursor: string }> } | undefined}
+	 */
+	namespace;
+
+	/**
+	 * 创建 KV 适配器实例。
+	 * Create a KV adapter instance.
+	 *
+	 * @param {{ get(key: string): Promise<string|null>; put(key: string, value: string): Promise<void>; delete(key: string): Promise<void>; list?(options?: { prefix?: string; limit?: number; cursor?: string }): Promise<{ keys: { name: string; expiration?: number; metadata?: object }[]; list_complete: boolean; cursor: string }> } | null | undefined} namespace KV namespace 绑定 / KV namespace binding.
+	 */
+	constructor(namespace) {
+		this.namespace = namespace ?? undefined;
+	}
+
+	/**
+	 * 读取存储值。
+	 * Read value from persistent storage.
+	 *
+	 * @param {string} keyName 键名或路径键 / Key or path key.
+	 * @param {*} [defaultValue=null] 默认值 / Default value when key is missing.
+	 * @returns {Promise<*>}
+	 */
+	async getItem(keyName, defaultValue = null) {
+		let keyValue = defaultValue;
+		switch (keyName.startsWith("@")) {
+			case true: {
+				const { key, path } = keyName.match(KV.#nameRegex)?.groups ?? {};
+				keyName = key;
+				let value = await this.getItem(keyName, {});
+				if (typeof value !== "object" || value === null) value = {};
+				keyValue = _.get(value, path);
+				keyValue = KV.#deserialize(keyValue);
+				break;
+			}
+			default:
+				switch ($app) {
+					case "Worker":
+						keyValue = await this.#getNamespace().get(keyName);
+						break;
+					default:
+						keyValue = Storage.getItem(keyName, defaultValue);
+						break;
+				}
+				keyValue = KV.#deserialize(keyValue);
+				break;
+		}
+		return keyValue ?? defaultValue;
+	}
+
+	/**
+	 * 写入存储值。
+	 * Write value into persistent storage.
+	 *
+	 * @param {string} keyName 键名或路径键 / Key or path key.
+	 * @param {*} keyValue 写入值 / Value to store.
+	 * @returns {Promise<boolean>}
+	 */
+	async setItem(keyName = new String(), keyValue = new String()) {
+		let result = false;
+		keyValue = KV.#serialize(keyValue);
+		switch (keyName.startsWith("@")) {
+			case true: {
+				const { key, path } = keyName.match(KV.#nameRegex)?.groups ?? {};
+				keyName = key;
+				let value = await this.getItem(keyName, {});
+				if (typeof value !== "object" || value === null) value = {};
+				_.set(value, path, keyValue);
+				result = await this.setItem(keyName, value);
+				break;
+			}
+			default:
+				switch ($app) {
+					case "Worker":
+						await this.#getNamespace().put(keyName, keyValue);
+						result = true;
+						break;
+					default:
+						result = Storage.setItem(keyName, keyValue);
+						break;
+				}
+				break;
+		}
+		return result;
+	}
+
+	/**
+	 * 删除存储值。
+	 * Remove value from persistent storage.
+	 *
+	 * @param {string} keyName 键名或路径键 / Key or path key.
+	 * @returns {Promise<boolean>}
+	 */
+	async removeItem(keyName) {
+		let result = false;
+		switch (keyName.startsWith("@")) {
+			case true: {
+				const { key, path } = keyName.match(KV.#nameRegex)?.groups ?? {};
+				keyName = key;
+				let value = await this.getItem(keyName);
+				if (typeof value !== "object" || value === null) value = {};
+				_.unset(value, path);
+				result = await this.setItem(keyName, value);
+				break;
+			}
+			default:
+				switch ($app) {
+					case "Worker":
+						await this.#getNamespace().delete(keyName);
+						result = true;
+						break;
+					default:
+						result = Storage.removeItem(keyName);
+						break;
+				}
+				break;
+		}
+		return result;
+	}
+
+	/**
+	 * 清空存储。
+	 * Clear storage.
+	 *
+	 * @returns {Promise<boolean>}
+	 */
+	async clear() {
+		return false;
+	}
+
+	/**
+	 * 列出命名空间中的键。
+	 * List keys in the namespace.
+	 *
+	 * @param {{ prefix?: string; limit?: number; cursor?: string }} [options={}] 列举选项 / List options.
+	 * @returns {Promise<{ keys: { name: string; expiration?: number; metadata?: object }[]; list_complete: boolean; cursor: string }>}
+	 */
+	async list(options = {}) {
+		switch ($app) {
+			case "Worker": {
+				const namespace = this.#getNamespace();
+				if (typeof namespace.list !== "function") throw new TypeError("KV namespace binding with list() is required in Worker runtime.");
+				return await namespace.list(options);
+			}
+			default:
+				throw new TypeError("KV.list() is only supported in Worker runtime.");
+		}
+	}
+
+	/**
+	 * 解析 Worker 所需的 namespace 绑定。
+	 * Resolve the namespace binding required by Workers.
+	 *
+	 * @private
+	 * @returns {{ get(key: string): Promise<string|null>; put(key: string, value: string): Promise<void>; delete(key: string): Promise<void>; list?(options?: { prefix?: string; limit?: number; cursor?: string }): Promise<{ keys: { name: string; expiration?: number; metadata?: object }[]; list_complete: boolean; cursor: string }> }}
+	 */
+	#getNamespace() {
+		if (
+			!this.namespace ||
+			typeof this.namespace.get !== "function" ||
+			typeof this.namespace.put !== "function" ||
+			typeof this.namespace.delete !== "function"
+		) {
+			throw new TypeError("KV namespace binding is required in Worker runtime.");
+		}
+		return this.namespace;
+	}
+
+	/**
+	 * 尝试将字符串反序列化为原始值。
+	 * Try to deserialize a string into its original value.
+	 *
+	 * @private
+	 * @param {*} value 原始值 / Raw value.
+	 * @returns {*}
+	 */
+	static #deserialize(value) {
+		try {
+			return JSON.parse(value);
+		} catch (e) {
+			return value;
+		}
+	}
+
+	/**
+	 * 规范化待写入的值。
+	 * Normalize a value before persisting it.
+	 *
+	 * @private
+	 * @param {*} value 原始值 / Raw value.
+	 * @returns {string}
+	 */
+	static #serialize(value) {
+		switch (typeof value) {
+			case "object":
+				return JSON.stringify(value);
+			default:
+				return String(value);
+		}
+	}
+}

package/polyfill/fetch.mjs

@@ -245,9 +245,7 @@ export async function fetch(resource, options = {}) {
 		case "Node.js": {
 			// Worker 复用宿主 `fetch`；Node.js 优先复用原生 `fetch`，缺失时再回退到 `node-fetch`。
 			// Worker reuses host `fetch`; Node.js reuses native `fetch` first and falls back to `node-fetch`.
-			if (!globalThis.fetch) {
-				globalThis.fetch = require("node-fetch");
-			}
+			if (!globalThis.fetch) globalThis.fetch = require("node-fetch");
 			switch (resource["auto-cookie"]) {
 				case undefined:
 				case "true":

package/polyfill/index.js

@@ -1,5 +1,6 @@
 export * from "./Console.mjs";
 export * from "./fetch.mjs";
+export * from "./KV.mjs";
 export * from "./Lodash.mjs";
 export * from "./StatusTexts.mjs";
 export * from "./Storage.mjs";

package/types/modules/core.d.ts

@@ -0,0 +1,54 @@
+declare module "@nsnanocat/util" {
+	export type AppName =
+		| "Quantumult X"
+		| "Loon"
+		| "Shadowrocket"
+		| "Egern"
+		| "Surge"
+		| "Stash"
+		| "Worker"
+		| "Node.js";
+
+	export const $app: AppName | undefined;
+	export const $argument: Record<string, unknown>;
+	export const argument: typeof $argument;
+
+	export interface DonePayload {
+		status?: number | string;
+		url?: string;
+		headers?: Record<string, unknown>;
+		body?: string | ArrayBuffer | ArrayBufferView;
+		bodyBytes?: ArrayBuffer;
+		policy?: string;
+	}
+
+	export function done(object?: DonePayload): void;
+
+	export interface NotificationContentObject {
+		open?: string;
+		"open-url"?: string;
+		url?: string;
+		openUrl?: string;
+		copy?: string;
+		"update-pasteboard"?: string;
+		updatePasteboard?: string;
+		media?: string;
+		"media-url"?: string;
+		mediaUrl?: string;
+		mime?: string;
+		"auto-dismiss"?: number;
+		sound?: string;
+	}
+
+	export type NotificationContent = NotificationContentObject | string | number | boolean;
+
+	export function notification(
+		title?: string,
+		subtitle?: string,
+		body?: string,
+		content?: NotificationContent,
+	): void;
+
+	export function time(format: string, ts?: number): string;
+	export function wait(delay?: number): Promise<void>;
+}

package/types/modules/environment.d.ts

@@ -0,0 +1,4 @@
+declare module "@nsnanocat/util/lib/environment.mjs" {
+	export const $environment: Record<string, unknown>;
+	export function environment(): Record<string, unknown>;
+}

package/types/modules/fetch.d.ts

@@ -0,0 +1,29 @@
+declare module "@nsnanocat/util" {
+	export interface FetchRequest {
+		url: string;
+		method?: string;
+		headers?: Record<string, unknown>;
+		body?: string | ArrayBuffer | ArrayBufferView | object;
+		bodyBytes?: ArrayBuffer;
+		timeout?: number | string;
+		policy?: string;
+		redirection?: boolean;
+		"auto-redirect"?: boolean;
+		"auto-cookie"?: boolean | number | string;
+		opts?: Record<string, unknown>;
+		[key: string]: unknown;
+	}
+
+	export interface FetchResponse {
+		ok: boolean;
+		status: number;
+		statusCode?: number;
+		statusText?: string;
+		headers?: Record<string, unknown>;
+		body?: string | ArrayBuffer;
+		bodyBytes?: ArrayBuffer;
+		[key: string]: unknown;
+	}
+
+	export function fetch(resource: FetchRequest | string, options?: Partial<FetchRequest>): Promise<FetchResponse>;
+}

package/types/modules/getStorage.d.ts

@@ -0,0 +1,22 @@
+declare module "@nsnanocat/util/getStorage.mjs" {
+	export interface StorageProfile {
+		Settings: Record<string, unknown>;
+		Configs: Record<string, unknown>;
+		Caches: Record<string, unknown>;
+	}
+
+	export function traverseObject(
+		o: Record<string, unknown>,
+		c: (key: string, value: unknown) => unknown,
+	): Record<string, unknown>;
+
+	export function string2number(string: string): string | number;
+
+	export function value2array(value: string | number | boolean | string[] | null | undefined): Array<string | number | boolean>;
+
+	export default function getStorage(
+		key: string,
+		names: string | string[] | Array<string | string[]>,
+		database: Record<string, unknown>,
+	): StorageProfile;
+}

package/types/modules/kv.d.ts

@@ -0,0 +1,35 @@
+declare module "@nsnanocat/util" {
+	export interface KVNamespaceLike {
+		get(key: string): Promise<string | null>;
+		put(key: string, value: string): Promise<void>;
+		delete(key: string): Promise<void>;
+		list?(options?: KVListOptions): Promise<KVListResult>;
+	}
+
+	export interface KVListOptions {
+		prefix?: string;
+		limit?: number;
+		cursor?: string;
+	}
+
+	export interface KVListKey {
+		name: string;
+		expiration?: number;
+		metadata?: Record<string, unknown>;
+	}
+
+	export interface KVListResult {
+		keys: KVListKey[];
+		list_complete: boolean;
+		cursor: string;
+	}
+
+	export class KV {
+		constructor(namespace?: KVNamespaceLike | null);
+		getItem<T = unknown>(keyName: string, defaultValue?: T): Promise<T>;
+		setItem(keyName: string, keyValue: unknown): Promise<boolean>;
+		removeItem(keyName: string): Promise<boolean>;
+		clear(): Promise<boolean>;
+		list(options?: KVListOptions): Promise<KVListResult>;
+	}
+}

package/types/modules/polyfills.d.ts

@@ -0,0 +1,34 @@
+declare module "@nsnanocat/util" {
+	export class Console {
+		static clear(): void;
+		static count(label?: string): void;
+		static countReset(label?: string): void;
+		static debug(...msg: unknown[]): void;
+		static error(...msg: unknown[]): void;
+		static exception(...msg: unknown[]): void;
+		static group(label: string): number;
+		static groupEnd(): string | undefined;
+		static info(...msg: unknown[]): void;
+		static get logLevel(): "OFF" | "ERROR" | "WARN" | "INFO" | "DEBUG" | "ALL";
+		static set logLevel(level: number | string);
+		static log(...msg: unknown[]): void;
+		static time(label?: string): Map<string, number>;
+		static timeEnd(label?: string): boolean;
+		static timeLog(label?: string): void;
+		static warn(...msg: unknown[]): void;
+	}
+
+	export class Lodash {
+		static escape(string: string): string;
+		static get<T = unknown, D = undefined>(object?: Record<string, unknown>, path?: string | string[], defaultValue?: D): T | D;
+		static merge<T extends Record<string, unknown>>(object: T, ...sources: Array<Record<string, unknown> | null | undefined>): T;
+		static omit<T extends Record<string, unknown>>(object?: T, paths?: string | string[]): T;
+		static pick<T extends Record<string, unknown>, K extends keyof T>(object?: T, paths?: K | K[]): Pick<T, K>;
+		static set<T extends Record<string, unknown>>(object: T, path: string | string[], value: unknown): T;
+		static toPath(value: string): string[];
+		static unescape(string: string): string;
+		static unset(object?: Record<string, unknown>, path?: string | string[]): boolean;
+	}
+
+	export const StatusTexts: Record<number, string>;
+}

package/types/modules/storage.d.ts

@@ -0,0 +1,10 @@
+declare module "@nsnanocat/util" {
+	export class Storage {
+		static data: Record<string, unknown> | null;
+		static dataFile: string;
+		static getItem<T = unknown>(keyName: string, defaultValue?: T): T;
+		static setItem(keyName: string, keyValue: unknown): boolean;
+		static removeItem(keyName: string): boolean;
+		static clear(): boolean;
+	}
+}

package/types/nsnanocat-util.d.ts

@@ -1,152 +1,7 @@
-declare module "@nsnanocat/util" {
-	export type AppName =
-		| "Quantumult X"
-		| "Loon"
-		| "Shadowrocket"
-		| "Egern"
-		| "Surge"
-		| "Stash"
-		| "Worker"
-		| "Node.js";
-
-	export const $app: AppName | undefined;
-	export const $argument: Record<string, unknown>;
-	export const argument: typeof $argument;
-
-	export interface DonePayload {
-		status?: number | string;
-		url?: string;
-		headers?: Record<string, unknown>;
-		body?: string | ArrayBuffer | ArrayBufferView;
-		bodyBytes?: ArrayBuffer;
-		policy?: string;
-	}
-
-	export function done(object?: DonePayload): void;
-
-	export interface NotificationContentObject {
-		open?: string;
-		"open-url"?: string;
-		url?: string;
-		openUrl?: string;
-		copy?: string;
-		"update-pasteboard"?: string;
-		updatePasteboard?: string;
-		media?: string;
-		"media-url"?: string;
-		mediaUrl?: string;
-		mime?: string;
-		"auto-dismiss"?: number;
-		sound?: string;
-	}
-
-	export type NotificationContent = NotificationContentObject | string | number | boolean;
-
-	export function notification(
-		title?: string,
-		subtitle?: string,
-		body?: string,
-		content?: NotificationContent,
-	): void;
-
-	export function time(format: string, ts?: number): string;
-	export function wait(delay?: number): Promise<void>;
-
-	export interface FetchRequest {
-		url: string;
-		method?: string;
-		headers?: Record<string, unknown>;
-		body?: string | ArrayBuffer | ArrayBufferView | object;
-		bodyBytes?: ArrayBuffer;
-		timeout?: number | string;
-		policy?: string;
-		redirection?: boolean;
-		"auto-redirect"?: boolean;
-		"auto-cookie"?: boolean | number | string;
-		opts?: Record<string, unknown>;
-		[key: string]: unknown;
-	}
-
-	export interface FetchResponse {
-		ok: boolean;
-		status: number;
-		statusCode?: number;
-		statusText?: string;
-		headers?: Record<string, unknown>;
-		body?: string | ArrayBuffer;
-		bodyBytes?: ArrayBuffer;
-		[key: string]: unknown;
-	}
-
-	export function fetch(resource: FetchRequest | string, options?: Partial<FetchRequest>): Promise<FetchResponse>;
-
-	export class Console {
-		static clear(): void;
-		static count(label?: string): void;
-		static countReset(label?: string): void;
-		static debug(...msg: unknown[]): void;
-		static error(...msg: unknown[]): void;
-		static exception(...msg: unknown[]): void;
-		static group(label: string): number;
-		static groupEnd(): string | undefined;
-		static info(...msg: unknown[]): void;
-		static get logLevel(): "OFF" | "ERROR" | "WARN" | "INFO" | "DEBUG" | "ALL";
-		static set logLevel(level: number | string);
-		static log(...msg: unknown[]): void;
-		static time(label?: string): Map<string, number>;
-		static timeEnd(label?: string): boolean;
-		static timeLog(label?: string): void;
-		static warn(...msg: unknown[]): void;
-	}
-
-	export class Lodash {
-		static escape(string: string): string;
-		static get<T = unknown, D = undefined>(object?: Record<string, unknown>, path?: string | string[], defaultValue?: D): T | D;
-		static merge<T extends Record<string, unknown>>(object: T, ...sources: Array<Record<string, unknown> | null | undefined>): T;
-		static omit<T extends Record<string, unknown>>(object?: T, paths?: string | string[]): T;
-		static pick<T extends Record<string, unknown>, K extends keyof T>(object?: T, paths?: K | K[]): Pick<T, K>;
-		static set<T extends Record<string, unknown>>(object: T, path: string | string[], value: unknown): T;
-		static toPath(value: string): string[];
-		static unescape(string: string): string;
-		static unset(object?: Record<string, unknown>, path?: string | string[]): boolean;
-	}
-
-	export const StatusTexts: Record<number, string>;
-
-	export class Storage {
-		static data: Record<string, unknown> | null;
-		static dataFile: string;
-		static getItem<T = unknown>(keyName: string, defaultValue?: T): T;
-		static setItem(keyName: string, keyValue: unknown): boolean;
-		static removeItem(keyName: string): boolean;
-		static clear(): boolean;
-	}
-}
-
-declare module "@nsnanocat/util/getStorage.mjs" {
-	export interface StorageProfile {
-		Settings: Record<string, unknown>;
-		Configs: Record<string, unknown>;
-		Caches: Record<string, unknown>;
-	}
-
-	export function traverseObject(
-		o: Record<string, unknown>,
-		c: (key: string, value: unknown) => unknown,
-	): Record<string, unknown>;
-
-	export function string2number(string: string): string | number;
-
-	export function value2array(value: string | number | boolean | string[] | null | undefined): Array<string | number | boolean>;
-
-	export default function getStorage(
-		key: string,
-		names: string | string[] | Array<string | string[]>,
-		database: Record<string, unknown>,
-	): StorageProfile;
-}
-
-declare module "@nsnanocat/util/lib/environment.mjs" {
-	export const $environment: Record<string, unknown>;
-	export function environment(): Record<string, unknown>;
-}
+/// <reference path="./modules/core.d.ts" />
+/// <reference path="./modules/fetch.d.ts" />
+/// <reference path="./modules/polyfills.d.ts" />
+/// <reference path="./modules/storage.d.ts" />
+/// <reference path="./modules/kv.d.ts" />
+/// <reference path="./modules/getStorage.d.ts" />
+/// <reference path="./modules/environment.d.ts" />