@simplysm/core-common 13.0.41 → 13.0.43

package/README.md

@@ -58,6 +58,10 @@ To use extension methods (`getOrCreate()`, `toggle()`, etc.), you must import th
 - [`objGetChainValueByDepth`](docs/utils.md#objgetchainvaluebydepth) - Query value by descending the same key repeatedly
 - [`objSetChainValue`](docs/utils.md#objsetchainvalue) - Set value by chain path
 - [`objDeleteChainValue`](docs/utils.md#objdeletechainvalue) - Delete value by chain path
+- [`objClearUndefined`](docs/utils.md#objclearundefined) - Delete keys with `undefined` values (mutates original)
+- [`objClear`](docs/utils.md#objclear) - Delete all keys from an object (mutates original)
+- [`objNullToUndefined`](docs/utils.md#objnulltoundefined) - Recursively convert null to undefined (mutates original)
+- [`objUnflatten`](docs/utils.md#objunflatten) - Convert dot-notation flat object to nested object
 - [`objKeys`](docs/utils.md#objkeys) - Type-safe `Object.keys`
 - [`objEntries`](docs/utils.md#objentries) - Type-safe `Object.entries`
 - [`objFromEntries`](docs/utils.md#objfromentries) - Type-safe `Object.fromEntries`
@@ -206,7 +210,7 @@ To use extension methods (`getOrCreate()`, `toggle()`, etc.), you must import th
 - [`Bytes`](docs/types.md#bytes) - Alias for `Uint8Array`
 - [`PrimitiveTypeStr`](docs/types.md#primitivetypestr) - Primitive type string keys
 - [`PrimitiveTypeMap`](docs/types.md#primitivetypemap) - Mapping from type string to type
-- [`PrimitiveType`](docs/types.md#primitivetype) - Union of all primitive types
+- [`PrimitiveType`](docs/types.md#primitivetype) - Union of all primitive types (includes `undefined`)
 - [`DeepPartial`](docs/types.md#deeppartial) - Recursively convert properties to optional
 - [`Type`](docs/types.md#type) - Constructor type
 - [`ObjUndefToOptional`](docs/types.md#objundeftooptional) - Convert `undefined` properties to optional

package/docs/types.md

@@ -51,8 +51,18 @@ Timeout error. Thrown automatically by `waitUntil` when max attempts are exceede
 ```typescript
 import { TimeoutError } from "@simplysm/core-common";
 
+// Thrown automatically by waitUntil on timeout
+try {
+  await waitUntil(() => isReady, 100, 50);
+} catch (err) {
+  if (err instanceof TimeoutError) {
+    console.log("Timed out");
+  }
+}
+
+// Throw manually
 throw new TimeoutError(5, "API response wait exceeded");
-// Result message: "Wait time exceeded(5): API response wait exceeded"
+// count: number of attempts, message: additional description (both optional)
 ```
 
 ---
@@ -301,10 +311,10 @@ type PrimitiveTypeMap = {
 
 ### PrimitiveType
 
-Union of all Primitive types.
+Union of all Primitive types (includes `undefined`).
 
 ```typescript
-type PrimitiveType = string | number | boolean | DateTime | DateOnly | Time | Uuid | Bytes;
+type PrimitiveType = string | number | boolean | DateTime | DateOnly | Time | Uuid | Bytes | undefined;
 ```
 
 ### DeepPartial

package/docs/utils.md

@@ -139,6 +139,51 @@ import { objDeleteChainValue } from "@simplysm/core-common";
 objDeleteChainValue(obj, "a.b[0].c");
 ```
 
+### objClearUndefined
+
+Delete keys with `undefined` values from an object (mutates the original).
+
+```typescript
+import { objClearUndefined } from "@simplysm/core-common";
+
+const obj = { a: 1, b: undefined, c: "hello" };
+objClearUndefined(obj); // { a: 1, c: "hello" }
+```
+
+### objClear
+
+Delete all keys from an object (mutates the original).
+
+```typescript
+import { objClear } from "@simplysm/core-common";
+
+const obj = { a: 1, b: 2 };
+objClear(obj); // {}
+```
+
+### objNullToUndefined
+
+Recursively convert `null` values to `undefined` (mutates the original object/array).
+
+```typescript
+import { objNullToUndefined } from "@simplysm/core-common";
+
+const data = { a: null, b: { c: null }, d: [null, 1] };
+objNullToUndefined(data);
+// { a: undefined, b: { c: undefined }, d: [undefined, 1] }
+```
+
+### objUnflatten
+
+Convert a flat object with dot-notation keys into a nested object.
+
+```typescript
+import { objUnflatten } from "@simplysm/core-common";
+
+objUnflatten({ "a.b.c": 1, "a.b.d": 2, "e": 3 });
+// { a: { b: { c: 1, d: 2 } }, e: 3 }
+```
+
 ### objKeys
 
 Type-safe `Object.keys`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simplysm/core-common",
-  "version": "13.0.41",
+  "version": "13.0.43",
   "description": "심플리즘 패키지 - 코어 모듈 (common)",
   "author": "김석래",
   "license": "Apache-2.0",