@goodbyenjn/utils 1.1.1 → 1.2.0

package/dist/fs.d.ts

@@ -1,5 +1,5 @@
-import { Result, ResultAsync } from "./libs/result-f34c580d.js";
-import "./libs/types-16d7a3e8.js";
+import "./libs/types-4042b7e8.js";
+import { Result, ResultAsync } from "./libs/result-81665e58.js";
 
 //#region src/fs/types.d.ts
 type PathLike = string | URL;

package/dist/fs.js

@@ -1,5 +1,5 @@
 import { e$3 as e } from "./libs/remeda-662cc9ef.js";
-import { errorToMessage, removePrefix } from "./libs/common-e8d0d8ef.js";
+import { errorToMessage, removePrefix } from "./libs/common-7de47aac.js";
 import { Result, ResultAsync, err, ok, safeTry } from "./libs/result-6175a096.js";
 import fs, { promises } from "node:fs";
 import path, { dirname } from "node:path";

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { ResultAsync } from "./libs/result-f34c580d.js";
-import { AsyncFn, Fn } from "./libs/types-16d7a3e8.js";
+import { AsyncFn, Fn } from "./libs/types-4042b7e8.js";
+import { ResultAsync } from "./libs/result-81665e58.js";
 
 //#region src/common/error.d.ts
 interface ErrorLike extends Partial<Error> {
@@ -30,16 +30,6 @@ declare const scale: (value: number, inRange: [min: number, max: number], outRan
 declare const parseKeyValuePairs: (input: string) => Record<string, string>;
 declare const parseValueToBoolean: (value: unknown, defaultValue: boolean) => boolean;
 //#endregion
-//#region src/common/process.d.ts
-declare function $(cmd: string): ResultAsync<{
-  stdout: string;
-  stderr: string;
-}, string>;
-declare function $(cmd: TemplateStringsArray, ...values: any[]): ResultAsync<{
-  stdout: string;
-  stderr: string;
-}, string>;
-//#endregion
 //#region src/common/promise.d.ts
 interface PromiseWithResolvers<T> {
   promise: Promise<T>;
@@ -72,6 +62,17 @@ declare const createLock: () => {
 };
 declare const PromiseWithResolvers: <T>() => PromiseWithResolvers<T>;
 //#endregion
+//#region src/common/shell.d.ts
+declare function $(cmd: string): ResultAsync<{
+  stdout: string;
+  stderr: string;
+}, string>;
+declare function $(cmd: TemplateStringsArray, ...values: any[]): ResultAsync<{
+  stdout: string;
+  stderr: string;
+}, string>;
+declare const quoteShellArg: (arg: string) => string;
+//#endregion
 //#region src/common/string.d.ts
 declare const addPrefix: (prefix: string, str: string) => string;
 declare const addSuffix: (suffix: string, str: string) => string;
@@ -137,4 +138,4 @@ type ThrottleOptions = Options;
 declare const debounce: <T extends Fn>(fn: T, wait?: number, options?: Options) => WrappedFn<T>;
 declare const throttle: <T extends Fn>(fn: T, wait?: number, options?: Options) => WrappedFn<T>;
 //#endregion
-export { $, type DebounceOptions, type DebouncedFn, type ErrorLike, PromiseWithResolvers, type ThrottleOptions, type ThrottledFn, addPrefix, addSuffix, createLock, createSingleton, debounce, errorToMessage, getErrorMessage, isErrorLike, join, joinWithSlash, linear, normalizeError, parseKeyValuePairs, parseValueToBoolean, removePrefix, removeSuffix, scale, sleep, split, splitWithSlash, template, throttle, toForwardSlash, unindent };
+export { $, type DebounceOptions, type DebouncedFn, type ErrorLike, PromiseWithResolvers, type ThrottleOptions, type ThrottledFn, addPrefix, addSuffix, createLock, createSingleton, debounce, errorToMessage, getErrorMessage, isErrorLike, join, joinWithSlash, linear, normalizeError, parseKeyValuePairs, parseValueToBoolean, quoteShellArg, removePrefix, removeSuffix, scale, sleep, split, splitWithSlash, template, throttle, toForwardSlash, unindent };

package/dist/index.js

@@ -1,5 +1,5 @@
 import "./libs/remeda-662cc9ef.js";
-import { $, PromiseWithResolvers, addPrefix, addSuffix, createLock, createSingleton, debounce, errorToMessage, getErrorMessage, isErrorLike, join, joinWithSlash, linear, normalizeError, parseKeyValuePairs, parseValueToBoolean, removePrefix, removeSuffix, scale, sleep, split, splitWithSlash, template, throttle, toForwardSlash, unindent } from "./libs/common-e8d0d8ef.js";
+import { $, PromiseWithResolvers, addPrefix, addSuffix, createLock, createSingleton, debounce, errorToMessage, getErrorMessage, isErrorLike, join, joinWithSlash, linear, normalizeError, parseKeyValuePairs, parseValueToBoolean, quoteShellArg, removePrefix, removeSuffix, scale, sleep, split, splitWithSlash, template, throttle, toForwardSlash, unindent } from "./libs/common-7de47aac.js";
 import "./libs/result-6175a096.js";
 
-export { $, PromiseWithResolvers, addPrefix, addSuffix, createLock, createSingleton, debounce, errorToMessage, getErrorMessage, isErrorLike, join, joinWithSlash, linear, normalizeError, parseKeyValuePairs, parseValueToBoolean, removePrefix, removeSuffix, scale, sleep, split, splitWithSlash, template, throttle, toForwardSlash, unindent };
+export { $, PromiseWithResolvers, addPrefix, addSuffix, createLock, createSingleton, debounce, errorToMessage, getErrorMessage, isErrorLike, join, joinWithSlash, linear, normalizeError, parseKeyValuePairs, parseValueToBoolean, quoteShellArg, removePrefix, removeSuffix, scale, sleep, split, splitWithSlash, template, throttle, toForwardSlash, unindent };

package/dist/libs/{common-e8d0d8ef.js → common-7de47aac.js}

@@ -198,7 +198,7 @@ const PromiseWithResolvers = () => {
 };
 
 //#endregion
-//#region src/common/process.ts
+//#region src/common/shell.ts
 function $(cmd, ...values) {
 	const command = t(cmd) ? cmd : cmd.reduce((acc, part, index) => acc + part + (values[index] ?? ""), "");
 	const promise = import("node:child_process").then(({ exec }) => {
@@ -214,6 +214,18 @@ function $(cmd, ...values) {
 	});
 	return ResultAsync.fromPromise(promise, errorToMessage(`Failed to execute command: ${cmd}`));
 }
+const REGEXP_NULL_CHAR = /\x00+/g;
+const REGEXP_SAFE_CHARS = /^[A-Za-z0-9,:=_./-]+$/;
+const REGEXP_SINGLE_QUOTES = /'+/g;
+const quoteShellArg = (arg) => {
+	if (!arg) return "''";
+	const cleaned = String(arg).replace(REGEXP_NULL_CHAR, "");
+	const matches = REGEXP_SAFE_CHARS.exec(cleaned);
+	if (matches?.[0].length === cleaned.length) return cleaned;
+	const quoted = cleaned.replace(REGEXP_SINGLE_QUOTES, (matched) => matched.length === 1 ? `'\\''` : `'"${matched}"'`);
+	const trimmed = `'${quoted}'`.replace(/^''/, "").replace(/''$/, "");
+	return trimmed;
+};
 
 //#endregion
 //#region src/common/string.ts
@@ -317,4 +329,4 @@ const throttle = (fn, wait = 0, options = {}) => {
 };
 
 //#endregion
-export { $, PromiseWithResolvers, addPrefix, addSuffix, createLock, createSingleton, debounce, errorToMessage, getErrorMessage, isErrorLike, join, joinWithSlash, linear, normalizeError, parseKeyValuePairs, parseValueToBoolean, removePrefix, removeSuffix, scale, sleep, split, splitWithSlash, template, throttle, toForwardSlash, unindent };
+export { $, PromiseWithResolvers, addPrefix, addSuffix, createLock, createSingleton, debounce, errorToMessage, getErrorMessage, isErrorLike, join, joinWithSlash, linear, normalizeError, parseKeyValuePairs, parseValueToBoolean, quoteShellArg, removePrefix, removeSuffix, scale, sleep, split, splitWithSlash, template, throttle, toForwardSlash, unindent };

package/dist/libs/{result-f34c580d.d.ts → result-81665e58.d.ts}

@@ -1,4 +1,4 @@
-import { AsyncFn, Fn, NonEmptyTuple, Promisable } from "./types-16d7a3e8.js";
+import { AsyncFn, Fn, NonEmptyTuple, Promisable } from "./types-4042b7e8.js";
 
 //#region src/result/types.d.ts
 type ExtractOkTypes<T extends readonly Result[]> = { [K in keyof T]: T[K] extends Result<infer U, unknown> ? U : never };

package/dist/remeda.d.ts

@@ -1,4 +1,4 @@
-import { And, ArraySlice, CamelCase, EmptyObject, GreaterThan, GreaterThanOrEqual, IfNever, IntRange, IsAny, IsEqual, IsFloat, IsInteger, IsLiteral, IsNegative, IsNever, IsNumericLiteral, IsStringLiteral, IsSymbolLiteral, Join, KeysOfUnion, LastArrayElement, LessThan, Merge, MergeDeep, NonNegative, NonNegativeInteger, Or, ReadonlyTuple, RequireAtLeastOne, SharedUnionFields, Simplify, Split, Subtract, Tagged, ValueOf, Words, Writable } from "./libs/types-16d7a3e8.js";
+import { And, ArraySlice, CamelCase, EmptyObject, GreaterThan, GreaterThanOrEqual, IfNever, IntRange, IsAny, IsEqual, IsFloat, IsInteger, IsLiteral, IsNegative, IsNever, IsNumericLiteral, IsStringLiteral, IsSymbolLiteral, Join, KeysOfUnion, LastArrayElement, LessThan, Merge, MergeDeep, NonNegative, NonNegativeInteger, Or, ReadonlyTuple, RequireAtLeastOne, SharedUnionFields, Simplify, Split, Subtract, Tagged, ValueOf, Words, Writable } from "./libs/types-4042b7e8.js";
 
 //#region src/remeda/types.d.ts
 

package/dist/result.d.ts

@@ -1,3 +1,3 @@
-import { Err, Ok, Result, ResultAsync, err, errAsync, ok, okAsync, safeTry } from "./libs/result-f34c580d.js";
-import "./libs/types-16d7a3e8.js";
+import "./libs/types-4042b7e8.js";
+import { Err, Ok, Result, ResultAsync, err, errAsync, ok, okAsync, safeTry } from "./libs/result-81665e58.js";
 export { Err, Ok, Result, ResultAsync, err, errAsync, ok, okAsync, safeTry };

package/dist/types.d.ts

@@ -1,2 +1,2 @@
-import { AbstractClass, AbstractConstructor, AllUnionFields, And, ArrayIndices, ArraySlice, ArraySplice, ArrayTail, ArrayValues, Arrayable, AsyncFn, AsyncFnWithThis, AsyncReturnType, Asyncify, CamelCase, CamelCasedProperties, CamelCasedPropertiesDeep, Class, ConditionalExcept, ConditionalKeys, ConditionalPick, ConditionalPickDeep, ConditionalPickDeepOptions, Constructor, DelimiterCase, DelimiterCasedProperties, DelimiterCasedPropertiesDeep, DistributedOmit, DistributedPick, EmptyObject, Entries, Entry, Exact, Except, FindGlobalInstanceType, FindGlobalType, Finite, FixedLengthArray, Float, Fn, FnWithThis, Get, GetTagMetadata, GlobalThis, GreaterThan, GreaterThanOrEqual, HasOptionalKeys, HasReadonlyKeys, HasRequiredKeys, HasWritableKeys, IfAny, IfEmptyObject, IfNever, IfNull, IfUnknown, Includes, IntClosedRange, IntRange, Integer, InvariantOf, IsAny, IsBooleanLiteral, IsEmptyObject, IsEqual, IsFloat, IsInteger, IsLiteral, IsNegative, IsNever, IsNull, IsNumericLiteral, IsStringLiteral, IsSymbolLiteral, IsTuple, IsUnknown, IterableElement, Join, JsonArray, JsonObject, JsonPrimitive, JsonValue, Jsonifiable, Jsonify, KebabCase, KebabCasedProperties, KebabCasedPropertiesDeep, KeysOfUnion, LastArrayElement, LessThan, LessThanOrEqual, LiteralToPrimitive, LiteralToPrimitiveDeep, LiteralUnion, Merge, MergeDeep, MergeDeepOptions, MergeExclusive, MultidimensionalArray, MultidimensionalReadonlyArray, Negative, NegativeFloat, NegativeInfinity, NegativeInteger, NonEmptyObject, NonEmptyString, NonEmptyTuple, NonNegative, NonNegativeInteger, Nullable, OmitByKey, OmitDeep, OmitIndexSignature, Opaque, OptionalKeysOf, Or, OverrideProperties, PackageJson, PartialDeep, PartialDeepOptions, PartialOnUndefinedDeep, PartialOnUndefinedDeepOptions, PascalCase, PascalCasedProperties, PascalCasedPropertiesDeep, Paths, PickDeep, PickIndexSignature, PositiveInfinity, Primitive, Promisable, ReadonlyDeep, ReadonlyKeysOf, ReadonlyTuple, Replace, RequireAllOrNone, RequireAtLeastOne, RequireExactlyOne, RequireOneOrNone, RequiredDeep, RequiredKeysOf, Schema, SchemaOptions, ScreamingSnakeCase, SetFieldType, SetNonNullable, SetOptional, SetParameterType, SetReadonly, SetRequired, SetRequiredDeep, SetReturnType, SharedUnionFields, SharedUnionFieldsDeep, Simplify, SimplifyDeep, SingleKeyObject, SnakeCase, SnakeCasedProperties, SnakeCasedPropertiesDeep, Split, Spread, StringKeyOf, StringRepeat, StringSlice, Stringified, StructuredCloneable, Subtract, Sum, Tagged, TaggedUnion, Trim, TsConfigJson, TupleToObject, TupleToUnion, TypedArray, UndefinedOnPartialDeep, UnionToIntersection, UnionToTuple, UnknownArray, UnknownMap, UnknownRecord, UnknownSet, UnwrapOpaque, UnwrapTagged, ValueOf, Words, Writable, WritableDeep, WritableKeysOf, YieldType } from "./libs/types-16d7a3e8.js";
+import { AbstractClass, AbstractConstructor, AllUnionFields, And, ArrayIndices, ArraySlice, ArraySplice, ArrayTail, ArrayValues, Arrayable, AsyncFn, AsyncFnWithThis, AsyncReturnType, Asyncify, CamelCase, CamelCasedProperties, CamelCasedPropertiesDeep, Class, ConditionalExcept, ConditionalKeys, ConditionalPick, ConditionalPickDeep, ConditionalPickDeepOptions, Constructor, DelimiterCase, DelimiterCasedProperties, DelimiterCasedPropertiesDeep, DistributedOmit, DistributedPick, EmptyObject, Entries, Entry, Exact, Except, FindGlobalInstanceType, FindGlobalType, Finite, FixedLengthArray, Float, Fn, FnWithThis, Get, GetTagMetadata, GlobalThis, GreaterThan, GreaterThanOrEqual, HasOptionalKeys, HasReadonlyKeys, HasRequiredKeys, HasWritableKeys, IfAny, IfEmptyObject, IfNever, IfNull, IfUnknown, Includes, IntClosedRange, IntRange, Integer, InvariantOf, IsAny, IsBooleanLiteral, IsEmptyObject, IsEqual, IsFloat, IsInteger, IsLiteral, IsNegative, IsNever, IsNull, IsNumericLiteral, IsStringLiteral, IsSymbolLiteral, IsTuple, IsUnknown, IterableElement, Join, JsonArray, JsonObject, JsonPrimitive, JsonValue, Jsonifiable, Jsonify, KebabCase, KebabCasedProperties, KebabCasedPropertiesDeep, KeysOfUnion, LastArrayElement, LessThan, LessThanOrEqual, LiteralToPrimitive, LiteralToPrimitiveDeep, LiteralUnion, Merge, MergeDeep, MergeDeepOptions, MergeExclusive, MultidimensionalArray, MultidimensionalReadonlyArray, Negative, NegativeFloat, NegativeInfinity, NegativeInteger, NonEmptyObject, NonEmptyString, NonEmptyTuple, NonNegative, NonNegativeInteger, Nullable, OmitByKey, OmitDeep, OmitIndexSignature, Opaque, OptionalKeysOf, Or, OverrideProperties, PackageJson, PartialDeep, PartialDeepOptions, PartialOnUndefinedDeep, PartialOnUndefinedDeepOptions, PascalCase, PascalCasedProperties, PascalCasedPropertiesDeep, Paths, PickDeep, PickIndexSignature, PositiveInfinity, Primitive, Promisable, ReadonlyDeep, ReadonlyKeysOf, ReadonlyTuple, Replace, RequireAllOrNone, RequireAtLeastOne, RequireExactlyOne, RequireOneOrNone, RequiredDeep, RequiredKeysOf, Schema, SchemaOptions, ScreamingSnakeCase, SetFieldType, SetNonNullable, SetOptional, SetParameterType, SetReadonly, SetRequired, SetRequiredDeep, SetReturnType, SharedUnionFields, SharedUnionFieldsDeep, Simplify, SimplifyDeep, SingleKeyObject, SnakeCase, SnakeCasedProperties, SnakeCasedPropertiesDeep, Split, Spread, StringKeyOf, StringRepeat, StringSlice, Stringified, StructuredCloneable, Subtract, Sum, Tagged, TaggedUnion, Trim, TsConfigJson, TupleToObject, TupleToUnion, TypedArray, UndefinedOnPartialDeep, UnionToIntersection, UnionToTuple, UnknownArray, UnknownMap, UnknownRecord, UnknownSet, UnwrapOpaque, UnwrapTagged, ValueOf, Words, Writable, WritableDeep, WritableKeysOf, YieldType } from "./libs/types-4042b7e8.js";
 export { AbstractClass, AbstractConstructor, AllUnionFields, And, ArrayIndices, ArraySlice, ArraySplice, ArrayTail, ArrayValues, Arrayable, AsyncFn, AsyncFnWithThis, AsyncReturnType, Asyncify, CamelCase, CamelCasedProperties, CamelCasedPropertiesDeep, Class, ConditionalExcept, ConditionalKeys, ConditionalPick, ConditionalPickDeep, ConditionalPickDeepOptions, Constructor, DelimiterCase, DelimiterCasedProperties, DelimiterCasedPropertiesDeep, DistributedOmit, DistributedPick, EmptyObject, Entries, Entry, Exact, Except, FindGlobalInstanceType, FindGlobalType, Finite, FixedLengthArray, Float, Fn, FnWithThis, Get, GetTagMetadata, GlobalThis, GreaterThan, GreaterThanOrEqual, HasOptionalKeys, HasReadonlyKeys, HasRequiredKeys, HasWritableKeys, IfAny, IfEmptyObject, IfNever, IfNull, IfUnknown, Includes, IntClosedRange, IntRange, Integer, InvariantOf, IsAny, IsBooleanLiteral, IsEmptyObject, IsEqual, IsFloat, IsInteger, IsLiteral, IsNegative, IsNever, IsNull, IsNumericLiteral, IsStringLiteral, IsSymbolLiteral, IsTuple, IsUnknown, IterableElement, Join, JsonArray, JsonObject, JsonPrimitive, JsonValue, Jsonifiable, Jsonify, KebabCase, KebabCasedProperties, KebabCasedPropertiesDeep, KeysOfUnion, LastArrayElement, LessThan, LessThanOrEqual, LiteralToPrimitive, LiteralToPrimitiveDeep, LiteralUnion, Merge, MergeDeep, MergeDeepOptions, MergeExclusive, MultidimensionalArray, MultidimensionalReadonlyArray, Negative, NegativeFloat, NegativeInfinity, NegativeInteger, NonEmptyObject, NonEmptyString, NonEmptyTuple, NonNegative, NonNegativeInteger, Nullable, OmitByKey, OmitDeep, OmitIndexSignature, Opaque, OptionalKeysOf, Or, OverrideProperties as Override, OverrideProperties, PackageJson, SetOptional as PartialByKey, PartialDeep, PartialDeepOptions, PartialOnUndefinedDeep, PartialOnUndefinedDeepOptions, PascalCase, PascalCasedProperties, PascalCasedPropertiesDeep, Paths, PickDeep, PickIndexSignature, PositiveInfinity, Primitive, Promisable, ReadonlyDeep, ReadonlyKeysOf, ReadonlyTuple, Replace, RequireAllOrNone, RequireAtLeastOne, RequireExactlyOne, RequireOneOrNone, SetRequired as RequiredByKey, RequiredDeep, RequiredKeysOf, Schema, SchemaOptions, ScreamingSnakeCase, SetFieldType, SetNonNullable, SetOptional, SetParameterType, SetReadonly, SetRequired, SetRequiredDeep, SetReturnType, SharedUnionFields, SharedUnionFieldsDeep, Simplify, SimplifyDeep, SingleKeyObject, SnakeCase, SnakeCasedProperties, SnakeCasedPropertiesDeep, Split, Spread, StringKeyOf, StringRepeat, StringSlice, Stringified, StructuredCloneable, Subtract, Sum, Tagged, TaggedUnion, Trim, TsConfigJson, TupleToObject, TupleToUnion, TypedArray, UndefinedOnPartialDeep, UnionToIntersection, UnionToTuple, UnknownArray, UnknownMap, UnknownRecord, UnknownSet, UnwrapOpaque, UnwrapTagged, ValueOf, Words, Writable, WritableDeep, WritableKeysOf, YieldType };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@goodbyenjn/utils",
-    "version": "1.1.1",
+    "version": "1.2.0",
     "description": "GoodbyeNJN's utils for typescript and javascript",
     "keywords": [
         "utils",