@itshackers/utilix 0.0.0-stage → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Its Hacker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,304 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @itshackers/utilix
+
+Framework-independent TypeScript utilities for frontend and backend apps. The package has no runtime dependencies and ships ESM, CommonJS, and generated `.d.ts` files.
+
+This `README.md` is the file GitHub and npm both show. They are not different files unless you publish a separate one. Keep this document as the single source of truth.
+
+## Install
+
+```bash
+pnpm add @itshackers/utilix
+```
+
+Until it is published:
+
+```bash
+pnpm add @itshackers/utilix@file:../utilix
+```
+
+Node.js 18+ and modern browsers are supported. The compiled code does not use Node built-ins.
+
+## Run the project
+
+```bash
+cd utilix
+pnpm install
+pnpm test
+pnpm typecheck
+pnpm build
+```
+
+| Command | Purpose |
+| --- | --- |
+| `pnpm test` | Run unit tests once |
+| `pnpm test:watch` | Re-run tests on change |
+| `pnpm typecheck` | Strict TypeScript check |
+| `pnpm build` | Clean ESM + CJS + declaration build |
+| `pnpm dev` | Watch-mode build |
+| `pnpm prepublishOnly` | Typecheck, test, then build |
+
+`prepublishOnly` does not publish. See [Publish to npm](#publish-to-npm) for the first-release commands.
+
+## Imports
+
+```ts
+import { slugify, normalizeMobile, testPattern } from "@itshackers/utilix";
+
+import { toCamelCase } from "@itshackers/utilix/string";
+import { toNumber } from "@itshackers/utilix/number";
+import { slugify } from "@itshackers/utilix/slug";
+import { omitEmpty } from "@itshackers/utilix/common";
+import { formatPriceToLakh } from "@itshackers/utilix/format";
+import { parseIstDateTimeToUtc } from "@itshackers/utilix/date";
+import { normalizeMobile } from "@itshackers/utilix/phone";
+import { generatePassword } from "@itshackers/utilix/password";
+import { generatePrefixedCode } from "@itshackers/utilix/id";
+import { sanitizeForLog } from "@itshackers/utilix/sanitize";
+import { createSuccessResponse } from "@itshackers/utilix/response";
+import { ValidationPatterns, testPattern } from "@itshackers/utilix/regex";
+```
+
+CommonJS: `require("@itshackers/utilix")` and the same subpaths.
+
+## String — `@itshackers/utilix/string`
+
+| Function | Example | Result |
+| --- | --- | --- |
+| `toCamelCase(value)` | `toCamelCase("hello-world")` | `"helloWorld"` |
+| `toPascalCase(value)` | `toPascalCase("hello_world")` | `"HelloWorld"` |
+| `toSnakeCase(value)` | `toSnakeCase("Hello World")` | `"hello_world"` |
+| `toKebabCase(value)` | `toKebabCase("HelloWorld")` | `"hello-world"` |
+| `toTitleCase(value)` | `toTitleCase("used-truck")` | `"Used-Truck"` |
+| `convertCase(value, style?)` | `convertCase("hello-world", "camel")` | `"helloWorld"` |
+| `capitalize(value)` | `capitalize("  hello")` | `"Hello"` |
+| `normalizeWhitespace(value)` | `normalizeWhitespace(" a  b ")` | `"a b"` |
+| `replaceSeparatorsWithSpace(value)` | `replaceSeparatorsWithSpace("used-truck")` | `"Used Truck"` |
+| `htmlToPlainText(value)` | `htmlToPlainText("<p>Hi<br>There</p>")` | `"Hi There"` |
+| `nonEmptyString(value)` | `nonEmptyString("  Gold  ")` | `"Gold"` |
+| `escapeHtml(value)` | `escapeHtml("<b>")` | `"&lt;b&gt;"` |
+| `escapeRegex(value)` | `escapeRegex("a.b")` | `"a\\.b"` |
+
+`convertCase` styles: `title`, `lower`, `upper`, `camel`, `pascal`, `snake`, `kebab`, plus `*case` aliases. Unknown styles throw.
+
+`escapeHtml` and `htmlToPlainText` are not HTML sanitizers.
+
+## Number — `@itshackers/utilix/number`
+
+| Function | Example | Result |
+| --- | --- | --- |
+| `toNumber(value)` | `toNumber("12.5")` / `toNumber("1,234")` | `12.5` / `null` |
+| `toNumberIfValid(value)` | `toNumberIfValid("08")` / `toNumberIfValid("gold")` | `8` / `"gold"` |
+| `parsePositiveInt(value, fallback)` | `parsePositiveInt("0", 10)` | `10` |
+| `formatNumber(value, options?)` | `formatNumber(1234567.89)` | `"12,34,567.89"` |
+| `formatCurrency(value, currency?, locale?)` | `formatCurrency(1500)` | `"₹1,500.00"` |
+| `clamp(value, min, max)` | `clamp(15, 0, 10)` | `10` |
+| `roundTo(value, decimals?)` | `roundTo(1.2345, 2)` | `1.23` |
+
+Defaults: locale `en-IN`, currency `INR`. `toNumber` rejects locale grouping such as `"1,234"`.
+
+## Slug — `@itshackers/utilix/slug`
+
+```ts
+slugify("Cavalo Care — RSA Plans"); // "cavalo-care-rsa-plans"
+slugify("Hello World", { separator: "_" }); // "hello_world"
+slugify("Café Products", { preserveUnicode: false }); // "cafe-products"
+```
+
+Options: `separator` (`"-"`), `maxLength`, `preserveUnicode` (`true`). Slugs are not unique and are not full transliteration.
+
+## Common — `@itshackers/utilix/common`
+
+| Function | Example | Result |
+| --- | --- | --- |
+| `isPlainObject(value)` | `isPlainObject({})` / `isPlainObject([])` | `true` / `false` |
+| `isNilOrEmpty(value)` | `isNilOrEmpty("  ")` / `isNilOrEmpty(0)` | `true` / `false` |
+| `coalesce(value, fallback)` | `coalesce(null, "Silver")` | `"Silver"` |
+| `toBoolean(value, fallback?)` | `toBoolean("true")` / `toBoolean(null, true)` | `true` / `true` |
+| `deepTrim(value)` | `deepTrim({ name: "  Gold  " })` | `{ name: "Gold" }` |
+| `omitEmpty(value)` | `omitEmpty({ note: "", count: 0 })` | `{ count: 0 }` |
+| `pickAllowed(value, allowed, fallback)` | `pickAllowed("hi", ["en", "hi"], "en")` | `"hi"` |
+| `sleep(ms)` | `await sleep(250)` | `void` |
+
+## Format — `@itshackers/utilix/format`
+
+| Function | Example | Result |
+| --- | --- | --- |
+| `formatDateTime(value, options?)` | `formatDateTime("2024-01-15T00:00:00.000Z")` | IST date-time or `null` |
+| `formatFileSize(bytes, decimals?)` | `formatFileSize(1536)` | `"1.5 KB"` |
+| `formatDuration(seconds)` | `formatDuration(3661)` | `"1 hr 1 min 1 sec"` |
+| `formatDurationCompact(value, options?)` | `formatDurationCompact(3661)` | `"1h 1m 1s"` |
+| `formatPriceToLakh(price, decimals?)` | `formatPriceToLakh(2_000_000)` | `"20.00 Lakh"` |
+
+`formatDateTime` defaults to `en-IN` / `Asia/Kolkata`. Months in compact durations are labeled `mo`.
+
+## Date — `@itshackers/utilix/date`
+
+| Function | Use |
+| --- | --- |
+| `parseIstDateTimeToUtc(value)` | Naive `"YYYY-MM-DD HH:mm:ss"` is treated as IST |
+| `formatUtcToIstDateTime(value)` | UTC instant → `"YYYY-MM-DD HH:mm:ss"` IST |
+| `getIstDateParts(date?)` | `{ year, month, day, hour }` in IST |
+| `addCalendarDays(year, month, day, days)` | Calendar arithmetic |
+| `istDateTime(y, m, d, h?, min?, s?, ms?)` | Build an IST `Date` |
+| `getExpiryInfo(expiresAt, options?)` | Remaining time, `needsRefresh`, `isExpired` |
+| `getCalendarWindow(options?)` | Configurable IST booking window |
+
+```ts
+parseIstDateTimeToUtc("2024-01-15 05:30:00"); // 2024-01-15T00:00:00.000Z
+getExpiryInfo(expiresAt, { warningDays: 7, compact: true, now });
+getCalendarWindow({ cutoffHour: 14, windowDays: 36 });
+```
+
+## Phone — `@itshackers/utilix/phone`
+
+```ts
+normalizeMobile("+91 98765 43210"); // "9876543210"
+normalizeMobile("12345"); // null
+```
+
+Indian 10-digit numbers starting with 6-9 only.
+
+## Password — `@itshackers/utilix/password`
+
+```ts
+generatePassword();    // length 12
+generatePassword(16);  // minimum 8
+```
+
+Uses `crypto.getRandomValues`. This generates passwords; it does not hash them. Keep bcrypt/argon2 in the app.
+
+## ID — `@itshackers/utilix/id`
+
+```ts
+generatePrefixedCode({ prefix: "PLAN" });
+generatePrefixedCode({ prefix: "SAVE", randomLength: 6, includeTimestamp: false });
+```
+
+Does not guarantee uniqueness. Options: `prefix`, `randomLength`, `includeTimestamp`, `now`, `charset`.
+
+## Sanitize — `@itshackers/utilix/sanitize`
+
+```ts
+sanitizeForLog({ password: "secret", name: "Gold" });
+// { password: "[REDACTED]", name: "Gold" }
+
+sanitizeHeaders({ Authorization: "Bearer x", "content-type": "application/json" });
+```
+
+Configurable: `sensitiveKeys`, `maxDepth`, `maxString`, `maxArray`, `redactedValue`, `truncatedValue`.
+
+## Response — `@itshackers/utilix/response`
+
+Framework-independent payloads. These do not call Express `res.json`.
+
+```ts
+createSuccessResponse({
+  message: "Created",
+  data: { id: 1 },
+  requestId: "req-1",
+});
+
+createErrorResponse({
+  message: "Invalid mobile",
+  code: "VALIDATION_ERROR",
+  errors: { mobile: ["required"] },
+});
+```
+
+## Regex — `@itshackers/utilix/regex`
+
+Shape checks only. Not official document validation.
+
+```ts
+ValidationPatterns.EMAIL.test("user@example.com");
+testPattern("9876543210", "MOBILE");
+testPattern("123456", "OTP");
+getPattern("PINCODE");
+```
+
+| Name | Typical valid input |
+| --- | --- |
+| `YEAR` | `2024` |
+| `OTP` | `123456` |
+| `PINCODE` / `POSTAL_CODE` | `560001` |
+| `NUMERIC` | `42` |
+| `MOBILE` | `9876543210` |
+| `NAME` | `Ravi Kumar` |
+| `ALPHABETIC` | `Gold` |
+| `LOWERCASE_ONLY` | `gold_plan` |
+| `UPPERCASE_ONLY` | `GOLD_PLAN` |
+| `USERNAME` | `ravi_01` |
+| `LOWER_NUMERIC` | `plan_01` |
+| `UPPER_NUMERIC` | `PLAN_01` |
+| `LOWER_WITH_HYPHENS` | `gold-plan` |
+| `UPPER_WITH_HYPHENS` | `GOLD-PLAN` |
+| `ALPHANUMERIC` | `Gold 12` |
+| `PERMISSION_NAME` | `leads.create` |
+| `AADHAR_CARD` | `234567890123` |
+| `LOWER_NUMERIC_WITH_HYPHENS` | `plan-01` |
+| `UPPER_NUMERIC_WITH_HYPHENS` | `PLAN-01` |
+| `ALPHANUMERIC_WITH_SPACES` | `Gold 12` |
+| `ALPHANUMERIC_WITHOUT_SPACES` | `Gold12` |
+| `PAN_CARD` | `ABCDE1234F` |
+| `ALPHANUMERIC_WITH_UNDERSCORES` | `Gold_12` |
+| `MODEL_NAME` | `Tata 407` |
+| `NOTE` | `Follow up @ 10am` |
+| `EMAIL` | `user@example.com` |
+| `VEHICLE_NUMBER` | `KA01AB1234` |
+| `PASSWORD` | `Abcd1234@` |
+| `URL` | `https://example.com` |
+| `DATE` | `2024-01-15` |
+| `CURRENCY` | `1500.50` |
+| `TIME` | `09:30` |
+| `MESSAGE` | `Need RSA today` |
+| `DOMAIN_HOSTNAME` | `care.example.com` |
+
+## Limitations
+
+- No runtime password hashing. Use bcrypt/argon2 in the application.
+- No Express `res.status().json()` helpers. Use `createSuccessResponse` / `createErrorResponse`, then send the object yourself.
+- `escapeHtml` / `htmlToPlainText` are not sanitizers.
+- `toNumber` does not parse locale grouping.
+- `slugify` and `generatePrefixedCode` do not guarantee uniqueness.
+- `normalizeMobile` is Indian-only.
+- Validation patterns check shape, not official validity.
+- Duration months/years use 30-day and 365-day approximations.
+
+## Publish to npm
+
+Replace `OWNER/REPO` in `package.json` (`homepage`, `repository`, `bugs`) before the first release. Do not change `name` or `version` unless you intend a new identity or bump.
+
+This package is scoped (`@itshackers/utilix`) and already has `"publishConfig": { "access": "public" }`. Create the `@itshackers` npm organization first if it does not exist, then add your user to it.
+
+### First public release
+
+Run these from the package root after you have an npm account that can publish `@itshackers/*`:
+
+```bash
+cd "D:\Its Hacker\WORK_DIR\utilix"
+pnpm login
+pnpm prepublishOnly
+pnpm pack --dry-run
+pnpm publish --access public
+```
+
+If the account uses 2FA, npm will prompt for an OTP. You can also pass it:
+
+```bash
+pnpm publish --access public --otp 123456
+```
+
+`pnpm publish` runs `prepublishOnly` again (typecheck, tests, production build) and does not run unless you execute it.
+
+Inspect the tarball without publishing:
+
+```bash
+pnpm pack
+tar -tzf itshackers-utilix-0.3.0.tgz
+```
+
+The published files should be `package.json`, `README.md`, `LICENSE`, and `dist/**` only.
+
+## License
+
+MIT

package/dist/common/index.cjs

@@ -0,0 +1,102 @@
+'use strict';
+
+// src/internal/validation.ts
+function assertFiniteNumber(value, name) {
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    throw new TypeError(`${name} must be a finite number`);
+  }
+}
+
+// src/common/index.ts
+function isPlainObject(value) {
+  if (value === null || typeof value !== "object") {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === null || prototype === Object.prototype;
+}
+function isNilOrEmpty(value) {
+  if (value == null) {
+    return true;
+  }
+  if (typeof value === "string") {
+    return value.trim().length === 0;
+  }
+  return false;
+}
+function coalesce(value, fallback) {
+  return value ?? fallback;
+}
+function toBoolean(value, fallback = false) {
+  if (value === true || value === 1 || value === "1") {
+    return true;
+  }
+  if (value === false || value === 0 || value === "0") {
+    return false;
+  }
+  if (typeof value === "string") {
+    const normalized = value.trim().toLowerCase();
+    if (normalized.length === 0) {
+      return fallback;
+    }
+    if (normalized === "true") {
+      return true;
+    }
+    if (normalized === "false") {
+      return false;
+    }
+  }
+  if (value == null) {
+    return fallback;
+  }
+  return fallback;
+}
+function deepTrim(value) {
+  if (typeof value === "string") {
+    return value.trim();
+  }
+  if (Array.isArray(value)) {
+    return value.map((item) => deepTrim(item));
+  }
+  if (isPlainObject(value)) {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, nested]) => [key, deepTrim(nested)])
+    );
+  }
+  return value;
+}
+function omitEmpty(value) {
+  if (!isPlainObject(value)) {
+    return value;
+  }
+  const cleaned = { ...value };
+  for (const key of Object.keys(cleaned)) {
+    if (cleaned[key] === "" || cleaned[key] === null) {
+      delete cleaned[key];
+    }
+  }
+  return cleaned;
+}
+function pickAllowed(value, allowed, fallback) {
+  return allowed.includes(value) ? value : fallback;
+}
+function sleep(milliseconds) {
+  assertFiniteNumber(milliseconds, "milliseconds");
+  if (milliseconds < 0) {
+    throw new RangeError("milliseconds must be greater than or equal to 0");
+  }
+  return new Promise((resolve) => {
+    setTimeout(resolve, milliseconds);
+  });
+}
+
+exports.coalesce = coalesce;
+exports.deepTrim = deepTrim;
+exports.isNilOrEmpty = isNilOrEmpty;
+exports.isPlainObject = isPlainObject;
+exports.omitEmpty = omitEmpty;
+exports.pickAllowed = pickAllowed;
+exports.sleep = sleep;
+exports.toBoolean = toBoolean;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/common/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internal/validation.ts","../../src/common/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["export function assertFiniteNumber(\r\n  value: unknown,\r\n  name: string,\r\n): asserts value is number {\r\n  if (typeof value !== \"number\" || !Number.isFinite(value)) {\r\n    throw new TypeError(`${name} must be a finite number`);\r\n  }\r\n}\r\n\r\nexport function escapeRegExp(value: string): string {\r\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\r\n}\r\n","import { assertFiniteNumber } from \"../internal/validation.js\";\r\n\r\n/**\r\n * Returns `true` when the value is a plain object created by `{}`,\r\n * `Object.create(null)`, or `new Object()`. Arrays, `null`, and class\r\n * instances are rejected.\r\n */\r\nexport function isPlainObject(value: unknown): value is Record<string, unknown> {\r\n  if (value === null || typeof value !== \"object\") {\r\n    return false;\r\n  }\r\n\r\n  const prototype = Object.getPrototypeOf(value);\r\n  return prototype === null || prototype === Object.prototype;\r\n}\r\n\r\n/**\r\n * Returns `true` for `null`, `undefined`, and whitespace-only strings.\r\n * `0` and `false` are not treated as empty.\r\n */\r\nexport function isNilOrEmpty(value: unknown): boolean {\r\n  if (value == null) {\r\n    return true;\r\n  }\r\n\r\n  if (typeof value === \"string\") {\r\n    return value.trim().length === 0;\r\n  }\r\n\r\n  return false;\r\n}\r\n\r\n/**\r\n * Returns `value` unless it is `null` or `undefined`, in which case\r\n * `fallback` is returned.\r\n */\r\nexport function coalesce<T>(value: T | null | undefined, fallback: T): T {\r\n  return value ?? fallback;\r\n}\r\n\r\n/**\r\n * Coerces common truthy/falsey inputs to a boolean.\r\n * `null`, `undefined`, and empty or whitespace-only strings return `fallback`.\r\n *\r\n * @example\r\n * toBoolean(\"true\") // true\r\n * toBoolean(\"0\") // false\r\n * toBoolean(null, true) // true\r\n */\r\nexport function toBoolean(value: unknown, fallback = false): boolean {\r\n  if (value === true || value === 1 || value === \"1\") {\r\n    return true;\r\n  }\r\n\r\n  if (value === false || value === 0 || value === \"0\") {\r\n    return false;\r\n  }\r\n\r\n  if (typeof value === \"string\") {\r\n    const normalized = value.trim().toLowerCase();\r\n    if (normalized.length === 0) {\r\n      return fallback;\r\n    }\r\n    if (normalized === \"true\") {\r\n      return true;\r\n    }\r\n    if (normalized === \"false\") {\r\n      return false;\r\n    }\r\n  }\r\n\r\n  if (value == null) {\r\n    return fallback;\r\n  }\r\n\r\n  return fallback;\r\n}\r\n\r\n/**\r\n * Recursively trims strings in arrays and plain objects.\r\n * Dates, class instances, and other non-plain objects are left unchanged.\r\n *\r\n * @example\r\n * deepTrim({ name: \"  Gold  \", tags: [\"  rsa  \"] })\r\n * // { name: \"Gold\", tags: [\"rsa\"] }\r\n */\r\nexport function deepTrim<T>(value: T): T {\r\n  if (typeof value === \"string\") {\r\n    return value.trim() as T;\r\n  }\r\n\r\n  if (Array.isArray(value)) {\r\n    return value.map((item) => deepTrim(item)) as T;\r\n  }\r\n\r\n  if (isPlainObject(value)) {\r\n    return Object.fromEntries(\r\n      Object.entries(value).map(([key, nested]) => [key, deepTrim(nested)]),\r\n    ) as T;\r\n  }\r\n\r\n  return value;\r\n}\r\n\r\n/**\r\n * Returns a shallow copy of a plain object without `null` or empty-string values.\r\n * Non-plain values are returned unchanged.\r\n *\r\n * @example\r\n * omitEmpty({ name: \"Gold\", note: \"\", city: null })\r\n * // { name: \"Gold\" }\r\n */\r\nexport function omitEmpty<T>(value: T): T {\r\n  if (!isPlainObject(value)) {\r\n    return value;\r\n  }\r\n\r\n  const cleaned = { ...value };\r\n  for (const key of Object.keys(cleaned)) {\r\n    if (cleaned[key] === \"\" || cleaned[key] === null) {\r\n      delete cleaned[key];\r\n    }\r\n  }\r\n\r\n  return cleaned as T;\r\n}\r\n\r\n/**\r\n * Returns `value` when it is one of the allowed values, otherwise `fallback`.\r\n *\r\n * @example\r\n * pickAllowed(\"hi\", [\"en\", \"hi\"] as const, \"en\") // \"hi\"\r\n * pickAllowed(\"fr\", [\"en\", \"hi\"] as const, \"en\") // \"en\"\r\n */\r\nexport function pickAllowed<T>(\r\n  value: unknown,\r\n  allowed: readonly T[],\r\n  fallback: T,\r\n): T {\r\n  return allowed.includes(value as T) ? (value as T) : fallback;\r\n}\r\n\r\n/**\r\n * Resolves after the given number of milliseconds.\r\n */\r\nexport function sleep(milliseconds: number): Promise<void> {\r\n  assertFiniteNumber(milliseconds, \"milliseconds\");\r\n\r\n  if (milliseconds < 0) {\r\n    throw new RangeError(\"milliseconds must be greater than or equal to 0\");\r\n  }\r\n\r\n  return new Promise((resolve) => {\r\n    setTimeout(resolve, milliseconds);\r\n  });\r\n}\r\n"]}

package/dist/common/index.d.cts

@@ -0,0 +1,58 @@
+/**
+ * Returns `true` when the value is a plain object created by `{}`,
+ * `Object.create(null)`, or `new Object()`. Arrays, `null`, and class
+ * instances are rejected.
+ */
+declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Returns `true` for `null`, `undefined`, and whitespace-only strings.
+ * `0` and `false` are not treated as empty.
+ */
+declare function isNilOrEmpty(value: unknown): boolean;
+/**
+ * Returns `value` unless it is `null` or `undefined`, in which case
+ * `fallback` is returned.
+ */
+declare function coalesce<T>(value: T | null | undefined, fallback: T): T;
+/**
+ * Coerces common truthy/falsey inputs to a boolean.
+ * `null`, `undefined`, and empty or whitespace-only strings return `fallback`.
+ *
+ * @example
+ * toBoolean("true") // true
+ * toBoolean("0") // false
+ * toBoolean(null, true) // true
+ */
+declare function toBoolean(value: unknown, fallback?: boolean): boolean;
+/**
+ * Recursively trims strings in arrays and plain objects.
+ * Dates, class instances, and other non-plain objects are left unchanged.
+ *
+ * @example
+ * deepTrim({ name: "  Gold  ", tags: ["  rsa  "] })
+ * // { name: "Gold", tags: ["rsa"] }
+ */
+declare function deepTrim<T>(value: T): T;
+/**
+ * Returns a shallow copy of a plain object without `null` or empty-string values.
+ * Non-plain values are returned unchanged.
+ *
+ * @example
+ * omitEmpty({ name: "Gold", note: "", city: null })
+ * // { name: "Gold" }
+ */
+declare function omitEmpty<T>(value: T): T;
+/**
+ * Returns `value` when it is one of the allowed values, otherwise `fallback`.
+ *
+ * @example
+ * pickAllowed("hi", ["en", "hi"] as const, "en") // "hi"
+ * pickAllowed("fr", ["en", "hi"] as const, "en") // "en"
+ */
+declare function pickAllowed<T>(value: unknown, allowed: readonly T[], fallback: T): T;
+/**
+ * Resolves after the given number of milliseconds.
+ */
+declare function sleep(milliseconds: number): Promise<void>;
+
+export { coalesce, deepTrim, isNilOrEmpty, isPlainObject, omitEmpty, pickAllowed, sleep, toBoolean };

package/dist/common/index.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Returns `true` when the value is a plain object created by `{}`,
+ * `Object.create(null)`, or `new Object()`. Arrays, `null`, and class
+ * instances are rejected.
+ */
+declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Returns `true` for `null`, `undefined`, and whitespace-only strings.
+ * `0` and `false` are not treated as empty.
+ */
+declare function isNilOrEmpty(value: unknown): boolean;
+/**
+ * Returns `value` unless it is `null` or `undefined`, in which case
+ * `fallback` is returned.
+ */
+declare function coalesce<T>(value: T | null | undefined, fallback: T): T;
+/**
+ * Coerces common truthy/falsey inputs to a boolean.
+ * `null`, `undefined`, and empty or whitespace-only strings return `fallback`.
+ *
+ * @example
+ * toBoolean("true") // true
+ * toBoolean("0") // false
+ * toBoolean(null, true) // true
+ */
+declare function toBoolean(value: unknown, fallback?: boolean): boolean;
+/**
+ * Recursively trims strings in arrays and plain objects.
+ * Dates, class instances, and other non-plain objects are left unchanged.
+ *
+ * @example
+ * deepTrim({ name: "  Gold  ", tags: ["  rsa  "] })
+ * // { name: "Gold", tags: ["rsa"] }
+ */
+declare function deepTrim<T>(value: T): T;
+/**
+ * Returns a shallow copy of a plain object without `null` or empty-string values.
+ * Non-plain values are returned unchanged.
+ *
+ * @example
+ * omitEmpty({ name: "Gold", note: "", city: null })
+ * // { name: "Gold" }
+ */
+declare function omitEmpty<T>(value: T): T;
+/**
+ * Returns `value` when it is one of the allowed values, otherwise `fallback`.
+ *
+ * @example
+ * pickAllowed("hi", ["en", "hi"] as const, "en") // "hi"
+ * pickAllowed("fr", ["en", "hi"] as const, "en") // "en"
+ */
+declare function pickAllowed<T>(value: unknown, allowed: readonly T[], fallback: T): T;
+/**
+ * Resolves after the given number of milliseconds.
+ */
+declare function sleep(milliseconds: number): Promise<void>;
+
+export { coalesce, deepTrim, isNilOrEmpty, isPlainObject, omitEmpty, pickAllowed, sleep, toBoolean };

package/dist/common/index.js

@@ -0,0 +1,93 @@
+// src/internal/validation.ts
+function assertFiniteNumber(value, name) {
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    throw new TypeError(`${name} must be a finite number`);
+  }
+}
+
+// src/common/index.ts
+function isPlainObject(value) {
+  if (value === null || typeof value !== "object") {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === null || prototype === Object.prototype;
+}
+function isNilOrEmpty(value) {
+  if (value == null) {
+    return true;
+  }
+  if (typeof value === "string") {
+    return value.trim().length === 0;
+  }
+  return false;
+}
+function coalesce(value, fallback) {
+  return value ?? fallback;
+}
+function toBoolean(value, fallback = false) {
+  if (value === true || value === 1 || value === "1") {
+    return true;
+  }
+  if (value === false || value === 0 || value === "0") {
+    return false;
+  }
+  if (typeof value === "string") {
+    const normalized = value.trim().toLowerCase();
+    if (normalized.length === 0) {
+      return fallback;
+    }
+    if (normalized === "true") {
+      return true;
+    }
+    if (normalized === "false") {
+      return false;
+    }
+  }
+  if (value == null) {
+    return fallback;
+  }
+  return fallback;
+}
+function deepTrim(value) {
+  if (typeof value === "string") {
+    return value.trim();
+  }
+  if (Array.isArray(value)) {
+    return value.map((item) => deepTrim(item));
+  }
+  if (isPlainObject(value)) {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, nested]) => [key, deepTrim(nested)])
+    );
+  }
+  return value;
+}
+function omitEmpty(value) {
+  if (!isPlainObject(value)) {
+    return value;
+  }
+  const cleaned = { ...value };
+  for (const key of Object.keys(cleaned)) {
+    if (cleaned[key] === "" || cleaned[key] === null) {
+      delete cleaned[key];
+    }
+  }
+  return cleaned;
+}
+function pickAllowed(value, allowed, fallback) {
+  return allowed.includes(value) ? value : fallback;
+}
+function sleep(milliseconds) {
+  assertFiniteNumber(milliseconds, "milliseconds");
+  if (milliseconds < 0) {
+    throw new RangeError("milliseconds must be greater than or equal to 0");
+  }
+  return new Promise((resolve) => {
+    setTimeout(resolve, milliseconds);
+  });
+}
+
+export { coalesce, deepTrim, isNilOrEmpty, isPlainObject, omitEmpty, pickAllowed, sleep, toBoolean };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internal/validation.ts","../../src/common/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export function assertFiniteNumber(\r\n  value: unknown,\r\n  name: string,\r\n): asserts value is number {\r\n  if (typeof value !== \"number\" || !Number.isFinite(value)) {\r\n    throw new TypeError(`${name} must be a finite number`);\r\n  }\r\n}\r\n\r\nexport function escapeRegExp(value: string): string {\r\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\r\n}\r\n","import { assertFiniteNumber } from \"../internal/validation.js\";\r\n\r\n/**\r\n * Returns `true` when the value is a plain object created by `{}`,\r\n * `Object.create(null)`, or `new Object()`. Arrays, `null`, and class\r\n * instances are rejected.\r\n */\r\nexport function isPlainObject(value: unknown): value is Record<string, unknown> {\r\n  if (value === null || typeof value !== \"object\") {\r\n    return false;\r\n  }\r\n\r\n  const prototype = Object.getPrototypeOf(value);\r\n  return prototype === null || prototype === Object.prototype;\r\n}\r\n\r\n/**\r\n * Returns `true` for `null`, `undefined`, and whitespace-only strings.\r\n * `0` and `false` are not treated as empty.\r\n */\r\nexport function isNilOrEmpty(value: unknown): boolean {\r\n  if (value == null) {\r\n    return true;\r\n  }\r\n\r\n  if (typeof value === \"string\") {\r\n    return value.trim().length === 0;\r\n  }\r\n\r\n  return false;\r\n}\r\n\r\n/**\r\n * Returns `value` unless it is `null` or `undefined`, in which case\r\n * `fallback` is returned.\r\n */\r\nexport function coalesce<T>(value: T | null | undefined, fallback: T): T {\r\n  return value ?? fallback;\r\n}\r\n\r\n/**\r\n * Coerces common truthy/falsey inputs to a boolean.\r\n * `null`, `undefined`, and empty or whitespace-only strings return `fallback`.\r\n *\r\n * @example\r\n * toBoolean(\"true\") // true\r\n * toBoolean(\"0\") // false\r\n * toBoolean(null, true) // true\r\n */\r\nexport function toBoolean(value: unknown, fallback = false): boolean {\r\n  if (value === true || value === 1 || value === \"1\") {\r\n    return true;\r\n  }\r\n\r\n  if (value === false || value === 0 || value === \"0\") {\r\n    return false;\r\n  }\r\n\r\n  if (typeof value === \"string\") {\r\n    const normalized = value.trim().toLowerCase();\r\n    if (normalized.length === 0) {\r\n      return fallback;\r\n    }\r\n    if (normalized === \"true\") {\r\n      return true;\r\n    }\r\n    if (normalized === \"false\") {\r\n      return false;\r\n    }\r\n  }\r\n\r\n  if (value == null) {\r\n    return fallback;\r\n  }\r\n\r\n  return fallback;\r\n}\r\n\r\n/**\r\n * Recursively trims strings in arrays and plain objects.\r\n * Dates, class instances, and other non-plain objects are left unchanged.\r\n *\r\n * @example\r\n * deepTrim({ name: \"  Gold  \", tags: [\"  rsa  \"] })\r\n * // { name: \"Gold\", tags: [\"rsa\"] }\r\n */\r\nexport function deepTrim<T>(value: T): T {\r\n  if (typeof value === \"string\") {\r\n    return value.trim() as T;\r\n  }\r\n\r\n  if (Array.isArray(value)) {\r\n    return value.map((item) => deepTrim(item)) as T;\r\n  }\r\n\r\n  if (isPlainObject(value)) {\r\n    return Object.fromEntries(\r\n      Object.entries(value).map(([key, nested]) => [key, deepTrim(nested)]),\r\n    ) as T;\r\n  }\r\n\r\n  return value;\r\n}\r\n\r\n/**\r\n * Returns a shallow copy of a plain object without `null` or empty-string values.\r\n * Non-plain values are returned unchanged.\r\n *\r\n * @example\r\n * omitEmpty({ name: \"Gold\", note: \"\", city: null })\r\n * // { name: \"Gold\" }\r\n */\r\nexport function omitEmpty<T>(value: T): T {\r\n  if (!isPlainObject(value)) {\r\n    return value;\r\n  }\r\n\r\n  const cleaned = { ...value };\r\n  for (const key of Object.keys(cleaned)) {\r\n    if (cleaned[key] === \"\" || cleaned[key] === null) {\r\n      delete cleaned[key];\r\n    }\r\n  }\r\n\r\n  return cleaned as T;\r\n}\r\n\r\n/**\r\n * Returns `value` when it is one of the allowed values, otherwise `fallback`.\r\n *\r\n * @example\r\n * pickAllowed(\"hi\", [\"en\", \"hi\"] as const, \"en\") // \"hi\"\r\n * pickAllowed(\"fr\", [\"en\", \"hi\"] as const, \"en\") // \"en\"\r\n */\r\nexport function pickAllowed<T>(\r\n  value: unknown,\r\n  allowed: readonly T[],\r\n  fallback: T,\r\n): T {\r\n  return allowed.includes(value as T) ? (value as T) : fallback;\r\n}\r\n\r\n/**\r\n * Resolves after the given number of milliseconds.\r\n */\r\nexport function sleep(milliseconds: number): Promise<void> {\r\n  assertFiniteNumber(milliseconds, \"milliseconds\");\r\n\r\n  if (milliseconds < 0) {\r\n    throw new RangeError(\"milliseconds must be greater than or equal to 0\");\r\n  }\r\n\r\n  return new Promise((resolve) => {\r\n    setTimeout(resolve, milliseconds);\r\n  });\r\n}\r\n"]}