js-dev-tool 1.2.26 → 1.2.27

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "js-dev-tool",
-  "version": "1.2.26",
+  "version": "1.2.27",
   "type": "commonjs",
   "bin": {
     "jstool": "tools.js",

package/utils.d.ts

@@ -222,4 +222,20 @@ export declare function indexByCol<
   Entry extends Partial<Record<TProp, string | number>>,
   R extends Record<TKey, Entry>
 >(tsvSource: string, opt?: TCSVParseOpt): R;
-export const parseDelimitedToIndex: typeof indexByCol;
+export const parseDelimitedToIndex: typeof indexByCol;
+/**
+ * Type guard to check if a value is an object.
+ * @template {unknown} [T=Record<string, unknown>]
+ * @param {unknown} value Value to check.
+ * @returns {value is T} True if the value is an object.
+ * @date 2025/8/22 10:52:32 from `lmt`
+ */
+export declare const isObject: <T extends unknown = Record<string, unknown>>(value: unknown) => value is T;
+export type TTypeOfToken = "string" | "number" | "boolean" | "bigint" | "symbol" | "undefined" | "function" | "object";
+/**
+ * @template {unknown} T
+ * @param {unknown} data
+ * @param {Array<[property: string, type: TTypeOfToken]>} verifier
+ * @returns {data is T}
+ */
+export declare const isTypeOf: <T>(data: unknown, ...verifier: Array<[property: string, type: TTypeOfToken]>) => data is T;

package/utils.js

@@ -314,7 +314,7 @@ function execWithOutputResult(command, doneCallbackWithArgs, cwd) {
   });
 }
 /**
- * @import { TCSVParseOpt } from "./utils";
+ * @import { TCSVParseOpt, TTypeOfToken } from "./utils";
  */
 /**
  * Builds a key -> row index from a delimited text source (TSV by default).
@@ -473,6 +473,28 @@ function prependStringTo(str_array, content, suffix = "") {
     str_array[i++] = `${content}${suffix}${target}`;
   }
 }
+/**
+ * Type guard to check if a value is an object.
+ * @template {unknown} [T=Record<string, unknown>]
+ * @param {unknown} value Value to check.
+ * @returns {value is T} True if the value is an object.
+ * @date 2025/8/22 10:52:32 from `lmt`
+ */
+const isObject = (value) => typeof value === "object" && value !== null;
+/**
+ * @template {unknown} T
+ * @param {unknown} data
+ * @param {Array<[property: string, type: TTypeOfToken]>} verifier
+ * @returns {data is T}
+ */
+const isTypeOf = (data, ...verifier) => {
+  if (!isObject(data)) return false;
+  for (const [prop, type] of verifier) {
+    if (!(prop in data && typeof data[prop] === type))
+      return false;
+  }
+  return true;
+};
 module.exports = {
   prependStringTo,
   extractVersion,
@@ -500,5 +522,7 @@ module.exports = {
   log,
   listDependenciesOf,
   indexByCol,
-  parseDelimitedToIndex: indexByCol
+  parseDelimitedToIndex: indexByCol,
+  isObject,
+  isTypeOf,
 };