@nemigo/helpers 0.0.5 → 0.0.8

package/dist/cases.d.ts

@@ -0,0 +1,30 @@
+export type CaseResult<V, T> = (value: V | null, mutate: boolean) => T;
+/**
+ * Отлов строковых значений
+ *
+ * - `string` → `string`, `false`
+ * - `number` → `string`, `true`
+ * - `NaN` → `null`, `false`
+ * - `ETC` → `null`, `false`
+ */
+export declare const caseString: <T>(value: unknown, call: CaseResult<string, T>) => T;
+/**
+ * Отлов числовых значений
+ *
+ * - `number` → `number`, `false`
+ * - `string` → `number`, `true`
+ * - `NaN` → `null`, `false`
+ * - `ETC` → `null`, `false`
+ */
+export declare const caseNumber: <T>(value: unknown, call: CaseResult<number, T>) => T;
+/**
+ * Отлов булевых значений
+ *
+ * - `boolean` -> `boolean`, `false`
+ * - `"false"` -> `boolean`, `true`
+ * - `"true"` -> `boolean`, `true`
+ * - `0` -> `boolean`, `true`
+ * - `1` -> `boolean`, `true`
+ * - `ETC` → `null`, `false`
+ */
+export declare const caseBoolean: <T>(value: unknown, call: CaseResult<boolean, T>) => T;

package/dist/cases.js

@@ -0,0 +1,69 @@
+/**
+ * Отлов строковых значений
+ *
+ * - `string` → `string`, `false`
+ * - `number` → `string`, `true`
+ * - `NaN` → `null`, `false`
+ * - `ETC` → `null`, `false`
+ */
+export const caseString = (value, call) => {
+    switch (typeof value) {
+        case "string":
+            return call(value, false);
+        case "number":
+            if (!isNaN(value))
+                return call(String(value), true);
+    }
+    return call(null, false);
+};
+/**
+ * Отлов числовых значений
+ *
+ * - `number` → `number`, `false`
+ * - `string` → `number`, `true`
+ * - `NaN` → `null`, `false`
+ * - `ETC` → `null`, `false`
+ */
+export const caseNumber = (value, call) => {
+    switch (typeof value) {
+        case "number":
+            return call(isNaN(value) ? null : value, false);
+        case "string": {
+            const trimmed = value.trim();
+            const number = Number(trimmed);
+            if (!isNaN(number) && value !== "")
+                return call(number, true);
+        }
+    }
+    return call(null, false);
+};
+/**
+ * Отлов булевых значений
+ *
+ * - `boolean` -> `boolean`, `false`
+ * - `"false"` -> `boolean`, `true`
+ * - `"true"` -> `boolean`, `true`
+ * - `0` -> `boolean`, `true`
+ * - `1` -> `boolean`, `true`
+ * - `ETC` → `null`, `false`
+ */
+export const caseBoolean = (value, call) => {
+    switch (typeof value) {
+        case "boolean":
+            return call(value, false);
+        case "number":
+            if (value === 0)
+                return call(false, true);
+            if (value === 1)
+                return call(true, true);
+            break;
+        case "string": {
+            const flat = value.trim().toLowerCase();
+            if (flat === "false")
+                return call(false, true);
+            if (flat === "true")
+                return call(true, true);
+        }
+    }
+    return call(null, false);
+};

package/dist/lens.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Режим работы линзы:
+ * - `"exclude"` (исключение)
+ * - `"include"` (включение)
+ */
+export type LensMode = "exclude" | "include";
+export type LensSchema<O> = {
+    [K in keyof O]?: boolean;
+};
+/**
+ * Конфигурация для {@link Lens}
+ */
+export interface LensConfig<O> {
+    /**
+     * Режим работы линзы {@link LensMode}
+     *
+     * @default "exclude"
+     */
+    mode?: LensMode;
+    /**
+     * Схема, определяющая, какие ключи включить или исключить
+     *
+     * @default {}
+     */
+    schema?: LensSchema<O>;
+}
+/**
+ * Линза для фильтрации на основе схемы и режима
+ *
+ * @template O - Тип объект для схемы, с которой работает линза
+ */
+export declare class Lens<O> {
+    /**
+     * Режим работы линзы {@link LensMode}
+     *
+     * @default "exclude"
+     */
+    _mode: LensMode;
+    /**
+     * Схема, определяющая, какие ключи включить или исключить
+     *
+     * @default {}
+     */
+    _schema: LensSchema<O>;
+    /**
+     * Создаёт экземпляр линзы
+     *
+     * @param config - Конфигурация линзы {@link LensConfig}
+     */
+    constructor(config: LensConfig<O>);
+    /**
+     * Пересборка под другую конфигурацию
+     *
+     * @param config - Конфигурация линзы {@link LensConfig}
+     */
+    reconstruct(config: LensConfig<O>): void;
+    /**
+     * Проверяет, должен ли ключ быть включён в результат
+     *
+     * @param key - Ключ для проверки
+     * @returns `true`, если ключ должен быть включён, иначе `false`
+     */
+    get(key: keyof O): boolean;
+}

package/dist/lens.js

@@ -0,0 +1,50 @@
+/**
+ * Линза для фильтрации на основе схемы и режима
+ *
+ * @template O - Тип объект для схемы, с которой работает линза
+ */
+export class Lens {
+    /**
+     * Режим работы линзы {@link LensMode}
+     *
+     * @default "exclude"
+     */
+    _mode;
+    /**
+     * Схема, определяющая, какие ключи включить или исключить
+     *
+     * @default {}
+     */
+    _schema;
+    /**
+     * Создаёт экземпляр линзы
+     *
+     * @param config - Конфигурация линзы {@link LensConfig}
+     */
+    constructor(config) {
+        this.reconstruct(config);
+    }
+    /**
+     * Пересборка под другую конфигурацию
+     *
+     * @param config - Конфигурация линзы {@link LensConfig}
+     */
+    reconstruct(config) {
+        this._mode = config.mode ?? "exclude";
+        this._schema = config.schema ?? {};
+    }
+    /**
+     * Проверяет, должен ли ключ быть включён в результат
+     *
+     * @param key - Ключ для проверки
+     * @returns `true`, если ключ должен быть включён, иначе `false`
+     */
+    get(key) {
+        if (this._mode === "exclude") {
+            // Если в конфиге есть ключ в режиме исключения, то key false. Если нет — то true
+            return !this._schema[key];
+        }
+        // Если в конфиге есть ключ, то key true. Если нет — то false
+        return !!this._schema[key];
+    }
+}

package/dist/script.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Ищет значение флага в массиве аргументов процесса
+ *
+ * @param cmd - Команда, которой скрипт был запущен (`process.argv`)
+ * @param name - Имя флага, который нужно найти
+ * @param [strict=true] - Если `true`, выбрасывает ошибку, если флаг не найден. Если `false`, возвращает `null`
+ *
+ * @returns Значение флага (или `null`, если флаг не найден и `strict = false`)
+ * @throws {Error} Если `strict = true` и флаг не найден
+ */
+declare function getProcessFlag(cmd: string[], name: string, strict: boolean): string | null;
+declare function getProcessFlag(cmd: string[], name: string, strict?: true): string;
+export { getProcessFlag };

package/dist/script.js

@@ -0,0 +1,14 @@
+function getProcessFlag(cmd, name, strict = true) {
+    const argv = cmd.slice(2);
+    const index = argv.indexOf(name);
+    if (index > -1) {
+        const value = argv[index + 1];
+        if (value)
+            return value;
+    }
+    if (strict) {
+        throw new Error(`Флаг "${name}" не найден`);
+    }
+    return null;
+}
+export { getProcessFlag };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nemigo/helpers",
-	"version": "0.0.5",
+	"version": "0.0.8",
 	"private": false,
 	"author": {
 		"name": "Vlad Logvin",
@@ -15,10 +15,18 @@
 		"format": "prettier --write ./"
 	},
 	"exports": {
+		"./cases": {
+			"types": "./dist/cases.d.ts",
+			"default": "./dist/cases.js"
+		},
 		"./explorer": {
 			"types": "./dist/explorer.d.ts",
 			"default": "./dist/explorer.js"
 		},
+		"./lens": {
+			"types": "./dist/lens.d.ts",
+			"default": "./dist/lens.js"
+		},
 		"./msgpack": {
 			"types": "./dist/msgpack.d.ts",
 			"default": "./dist/msgpack.js"
@@ -26,6 +34,10 @@
 		"./random": {
 			"types": "./dist/random.d.ts",
 			"default": "./dist/random.js"
+		},
+		"./script": {
+			"types": "./dist/script.d.ts",
+			"default": "./dist/script.js"
 		}
 	},
 	"dependencies": {