@jeniex/utils 1.0.0

package/browser/index.cjs

@@ -0,0 +1,53 @@
+// @ts-nocheck
+
+'use strict';
+
+function isString(object) {
+    return typeof object === 'string';
+}
+
+function ensureJoin(object, separator = ',') {
+    if (isString(object)) {
+        return object;
+    }
+    return object.join(separator);
+}
+
+function asserted(object) {
+    if (object === null || object === undefined) {
+        throw new Error('Value is either null or undefined');
+    }
+    return object;
+}
+function isTruthy(object) {
+    return Boolean(object);
+}
+
+async function sleep(milliSeconds) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, milliSeconds);
+    });
+}
+
+function $(selectors, parent) {
+    const element = (parent ?? document).querySelector(ensureJoin(selectors));
+    if (element === null) {
+        throw new Error(`Couldn't find the element with the selector ${selectors}`);
+    }
+    return element;
+}
+function $$(selectors, parent) {
+    const elements = (parent ?? document).querySelectorAll(ensureJoin(selectors));
+    if (elements.length === 0) {
+        throw new Error(`Couldn't find any element with the selector ${selectors}`);
+    }
+    return elements;
+}
+
+exports.$ = $;
+exports.$$ = $$;
+exports.asserted = asserted;
+exports.ensureJoin = ensureJoin;
+exports.isString = isString;
+exports.isTruthy = isTruthy;
+exports.sleep = sleep;

package/browser/index.d.ts

@@ -0,0 +1,17 @@
+declare function ensureJoin(object: string[] | string, separator?: string): string;
+
+declare function asserted<T>(object: T | null | undefined): T;
+declare function isTruthy<T>(object: T): object is NonNullable<T>;
+
+declare function isString(object: unknown): object is string;
+
+declare function sleep(milliSeconds: number): Promise<void>;
+
+type Nullable<T> = T | null | undefined;
+
+type Parent = Document | HTMLElement;
+type Selectors = string[] | string;
+declare function $<T = HTMLElement>(selectors: Selectors, parent?: Parent): T;
+declare function $$<T extends Element = HTMLElement>(selectors: Selectors, parent?: Parent): NodeListOf<T>;
+
+export { $, $$, Nullable, asserted, ensureJoin, isString, isTruthy, sleep };

package/browser/index.mjs

@@ -0,0 +1,45 @@
+// @ts-nocheck
+
+function isString(object) {
+    return typeof object === 'string';
+}
+
+function ensureJoin(object, separator = ',') {
+    if (isString(object)) {
+        return object;
+    }
+    return object.join(separator);
+}
+
+function asserted(object) {
+    if (object === null || object === undefined) {
+        throw new Error('Value is either null or undefined');
+    }
+    return object;
+}
+function isTruthy(object) {
+    return Boolean(object);
+}
+
+async function sleep(milliSeconds) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, milliSeconds);
+    });
+}
+
+function $(selectors, parent) {
+    const element = (parent ?? document).querySelector(ensureJoin(selectors));
+    if (element === null) {
+        throw new Error(`Couldn't find the element with the selector ${selectors}`);
+    }
+    return element;
+}
+function $$(selectors, parent) {
+    const elements = (parent ?? document).querySelectorAll(ensureJoin(selectors));
+    if (elements.length === 0) {
+        throw new Error(`Couldn't find any element with the selector ${selectors}`);
+    }
+    return elements;
+}
+
+export { $, $$, asserted, ensureJoin, isString, isTruthy, sleep };

package/node/index.cjs

@@ -0,0 +1,59 @@
+// @ts-nocheck
+
+'use strict';
+
+var fs = require('node:fs');
+var fsp = require('node:fs/promises');
+var path = require('node:path');
+
+function isString(object) {
+    return typeof object === 'string';
+}
+
+function ensureJoin(object, separator = ',') {
+    if (isString(object)) {
+        return object;
+    }
+    return object.join(separator);
+}
+
+function asserted(object) {
+    if (object === null || object === undefined) {
+        throw new Error('Value is either null or undefined');
+    }
+    return object;
+}
+function isTruthy(object) {
+    return Boolean(object);
+}
+
+async function sleep(milliSeconds) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, milliSeconds);
+    });
+}
+
+async function listFolders({ folderPath, getFullPath }) {
+    if (fs.existsSync(folderPath) === false) {
+        throw new Error('The provided folder path does not exist!');
+    }
+    const items = await fsp.readdir(folderPath, {
+        withFileTypes: true,
+    });
+    const folders = items
+        .filter((item) => item.isDirectory() === true)
+        .map((folderItem) => {
+        if (getFullPath === undefined) {
+            return folderItem.name;
+        }
+        return path.join(folderPath, folderItem.name);
+    });
+    return folders;
+}
+
+exports.asserted = asserted;
+exports.ensureJoin = ensureJoin;
+exports.isString = isString;
+exports.isTruthy = isTruthy;
+exports.listFolders = listFolders;
+exports.sleep = sleep;

package/node/index.d.ts

@@ -0,0 +1,18 @@
+declare function ensureJoin(object: string[] | string, separator?: string): string;
+
+declare function asserted<T>(object: T | null | undefined): T;
+declare function isTruthy<T>(object: T): object is NonNullable<T>;
+
+declare function isString(object: unknown): object is string;
+
+declare function sleep(milliSeconds: number): Promise<void>;
+
+type Nullable<T> = T | null | undefined;
+
+interface ListFoldersOpt {
+    folderPath: string;
+    getFullPath?: boolean;
+}
+declare function listFolders({ folderPath, getFullPath }: ListFoldersOpt): Promise<string[]>;
+
+export { Nullable, asserted, ensureJoin, isString, isTruthy, listFolders, sleep };

package/node/index.mjs

@@ -0,0 +1,52 @@
+// @ts-nocheck
+
+import fs from 'node:fs';
+import fsp from 'node:fs/promises';
+import path from 'node:path';
+
+function isString(object) {
+    return typeof object === 'string';
+}
+
+function ensureJoin(object, separator = ',') {
+    if (isString(object)) {
+        return object;
+    }
+    return object.join(separator);
+}
+
+function asserted(object) {
+    if (object === null || object === undefined) {
+        throw new Error('Value is either null or undefined');
+    }
+    return object;
+}
+function isTruthy(object) {
+    return Boolean(object);
+}
+
+async function sleep(milliSeconds) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, milliSeconds);
+    });
+}
+
+async function listFolders({ folderPath, getFullPath }) {
+    if (fs.existsSync(folderPath) === false) {
+        throw new Error('The provided folder path does not exist!');
+    }
+    const items = await fsp.readdir(folderPath, {
+        withFileTypes: true,
+    });
+    const folders = items
+        .filter((item) => item.isDirectory() === true)
+        .map((folderItem) => {
+        if (getFullPath === undefined) {
+            return folderItem.name;
+        }
+        return path.join(folderPath, folderItem.name);
+    });
+    return folders;
+}
+
+export { asserted, ensureJoin, isString, isTruthy, listFolders, sleep };

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@jeniex/utils",
+  "version": "1.0.0",
+  "author": "JenieX",
+  "homepage": "https://github.com/JenieX/utils",
+  "type": "module",
+  "keywords": [
+    "utils"
+  ],
+  "exports": {
+    "./browser": {
+      "types": "./browser/index.d.ts",
+      "import": "./browser/index.mjs",
+      "require": "./browser/index.cjs"
+    },
+    "./node": {
+      "types": "./node/index.d.ts",
+      "import": "./node/index.mjs",
+      "require": "./node/index.cjs"
+    }
+  },
+  "files": [
+    "browser",
+    "node"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "develop": "npm run build -- --watch"
+  },
+  "devDependencies": {
+    "@jeniex/eslint-config": "^0.0.3",
+    "@rollup/plugin-typescript": "^11.1.3",
+    "@types/node": "^20.5.7",
+    "rollup": "^3.28.0",
+    "rollup-plugin-dts": "^5.3.1",
+    "tslib": "^2.6.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}