@simplysm/core-common 13.0.0-beta.3 → 13.0.0-beta.30

package/dist/common.types.js

@@ -1,5 +1,5 @@
-import { DateTime } from "./types/date-time";
-import { DateOnly } from "./types/date-only";
-import { Time } from "./types/time";
-import { Uuid } from "./types/uuid";
+import { DateTime } from "./types/date-time.js";
+import { DateOnly } from "./types/date-only.js";
+import { Time } from "./types/time.js";
+import { Uuid } from "./types/uuid.js";
 //# sourceMappingURL=common.types.js.map

package/dist/errors/argument-error.js

@@ -1,5 +1,5 @@
 import YAML from "yaml";
-import { SdError } from "./sd-error";
+import { SdError } from "./sd-error.js";
 class ArgumentError extends SdError {
   constructor(arg1, arg2) {
     const message = typeof arg1 === "string" ? arg1 : void 0;

package/dist/errors/not-implemented-error.js

@@ -1,4 +1,4 @@
-import { SdError } from "./sd-error";
+import { SdError } from "./sd-error.js";
 class NotImplementedError extends SdError {
   /**
    * @param message 추가 설명 메시지

package/dist/errors/timeout-error.js

@@ -1,4 +1,4 @@
-import { SdError } from "./sd-error";
+import { SdError } from "./sd-error.js";
 class TimeoutError extends SdError {
   /**
    * @param count 시도 횟수

package/dist/extensions/arr-ext.helpers.js

@@ -1,7 +1,7 @@
-import { DateTime } from "../types/date-time";
-import { DateOnly } from "../types/date-only";
-import { Time } from "../types/time";
-import { ArgumentError } from "../errors/argument-error";
+import { DateTime } from "../types/date-time.js";
+import { DateOnly } from "../types/date-only.js";
+import { Time } from "../types/time.js";
+import { ArgumentError } from "../errors/argument-error.js";
 function toComparable(value) {
   if (value instanceof DateOnly || value instanceof DateTime || value instanceof Time) {
     return value.tick;

package/dist/extensions/arr-ext.js

@@ -1,12 +1,12 @@
-import "./map-ext";
-import { objClone, objEqual, objMerge } from "../utils/obj";
-import { DateTime } from "../types/date-time";
-import { DateOnly } from "../types/date-only";
-import { Time } from "../types/time";
-import { Uuid } from "../types/uuid";
-import { ArgumentError } from "../errors/argument-error";
-import { SdError } from "../errors/sd-error";
-import { compareForOrder } from "./arr-ext.helpers";
+import "./map-ext.js";
+import { objClone, objEqual, objMerge } from "../utils/obj.js";
+import { DateTime } from "../types/date-time.js";
+import { DateOnly } from "../types/date-only.js";
+import { Time } from "../types/time.js";
+import { Uuid } from "../types/uuid.js";
+import { ArgumentError } from "../errors/argument-error.js";
+import { SdError } from "../errors/sd-error.js";
+import { compareForOrder } from "./arr-ext.helpers.js";
 const arrayReadonlyExtensions = {
   single(predicate) {
     const arr = predicate !== void 0 ? this.filter(predicate) : this;

package/dist/features/debounce-queue.js

@@ -1,5 +1,5 @@
-import { SdError } from "../errors/sd-error";
-import { EventEmitter } from "./event-emitter";
+import { SdError } from "../errors/sd-error.js";
+import { EventEmitter } from "./event-emitter.js";
 import { createConsola } from "consola";
 class DebounceQueue extends EventEmitter {
   /**

package/dist/features/serial-queue.js

@@ -1,7 +1,7 @@
-import { SdError } from "../errors/sd-error";
-import { EventEmitter } from "./event-emitter";
+import { SdError } from "../errors/sd-error.js";
+import { EventEmitter } from "./event-emitter.js";
 import { createConsola } from "consola";
-import { waitTime } from "../utils/wait";
+import { waitTime } from "../utils/wait.js";
 class SerialQueue extends EventEmitter {
   /**
    * @param _gap 각 작업 사이의 간격 (ms)

package/dist/index.js

@@ -1,31 +1,31 @@
-import "./extensions/arr-ext";
-import "./extensions/set-ext";
-import "./extensions/map-ext";
-export * from "./env";
-export * from "./errors/sd-error";
-export * from "./errors/argument-error";
-export * from "./errors/not-implemented-error";
-export * from "./errors/timeout-error";
-export * from "./types/uuid";
-export * from "./types/lazy-gc-map";
-export * from "./types/date-time";
-export * from "./types/date-only";
-export * from "./types/time";
-export * from "./features/debounce-queue";
-export * from "./features/serial-queue";
-export * from "./features/event-emitter";
-export * from "./utils/date-format";
-export * from "./utils/bytes";
-export * from "./utils/json";
-export * from "./utils/num";
-export * from "./utils/obj";
-export * from "./utils/primitive";
-export * from "./utils/str";
-export * from "./utils/template-strings";
-export * from "./utils/transferable";
-export * from "./utils/wait";
-export * from "./utils/xml";
-export * from "./utils/path";
-export * from "./zip/sd-zip";
-export * from "./common.types";
+import "./extensions/arr-ext.js";
+import "./extensions/set-ext.js";
+import "./extensions/map-ext.js";
+export * from "./env.js";
+export * from "./errors/sd-error.js";
+export * from "./errors/argument-error.js";
+export * from "./errors/not-implemented-error.js";
+export * from "./errors/timeout-error.js";
+export * from "./types/uuid.js";
+export * from "./types/lazy-gc-map.js";
+export * from "./types/date-time.js";
+export * from "./types/date-only.js";
+export * from "./types/time.js";
+export * from "./features/debounce-queue.js";
+export * from "./features/serial-queue.js";
+export * from "./features/event-emitter.js";
+export * from "./utils/date-format.js";
+export * from "./utils/bytes.js";
+export * from "./utils/json.js";
+export * from "./utils/num.js";
+export * from "./utils/obj.js";
+export * from "./utils/primitive.js";
+export * from "./utils/str.js";
+export * from "./utils/template-strings.js";
+export * from "./utils/transferable.js";
+export * from "./utils/wait.js";
+export * from "./utils/xml.js";
+export * from "./utils/path.js";
+export * from "./zip/sd-zip.js";
+export * from "./common.types.js";
 //# sourceMappingURL=index.js.map

package/dist/types/date-only.js

@@ -1,5 +1,5 @@
-import { ArgumentError } from "../errors/argument-error";
-import { formatDate, normalizeMonth } from "../utils/date-format";
+import { ArgumentError } from "../errors/argument-error.js";
+import { formatDate, normalizeMonth } from "../utils/date-format.js";
 class DateOnly {
   static MS_PER_DAY = 24 * 60 * 60 * 1e3;
   date;

package/dist/types/date-time.js

@@ -1,5 +1,5 @@
-import { ArgumentError } from "../errors/argument-error";
-import { convert12To24, formatDate, normalizeMonth } from "../utils/date-format";
+import { ArgumentError } from "../errors/argument-error.js";
+import { convert12To24, formatDate, normalizeMonth } from "../utils/date-format.js";
 class DateTime {
   date;
   constructor(arg1, arg2, arg3, arg4, arg5, arg6, arg7) {

package/dist/types/time.js

@@ -1,5 +1,5 @@
-import { ArgumentError } from "../errors/argument-error";
-import { convert12To24, formatDate } from "../utils/date-format";
+import { ArgumentError } from "../errors/argument-error.js";
+import { convert12To24, formatDate } from "../utils/date-format.js";
 class Time {
   static MS_PER_DAY = 24 * 60 * 60 * 1e3;
   _tick;

package/dist/types/uuid.js

@@ -1,4 +1,4 @@
-import { ArgumentError } from "../errors/argument-error";
+import { ArgumentError } from "../errors/argument-error.js";
 class Uuid {
   // 0x00 ~ 0xFF에 대한 hex 문자열 미리 계산 (256개)
   static _hexTable = Array.from({ length: 256 }, (_, i) => i.toString(16).padStart(2, "0"));

package/dist/utils/bytes.js

@@ -1,4 +1,4 @@
-import { ArgumentError } from "../errors/argument-error";
+import { ArgumentError } from "../errors/argument-error.js";
 const hexTable = Array.from({ length: 256 }, (_, i) => i.toString(16).padStart(2, "0"));
 const BASE64_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
 const BASE64_LOOKUP = Array.from({ length: 256 }, (_, i) => {

package/dist/utils/json.js

@@ -1,11 +1,11 @@
-import { DateTime } from "../types/date-time";
-import { DateOnly } from "../types/date-only";
-import { Time } from "../types/time";
-import { Uuid } from "../types/uuid";
-import { objNullToUndefined } from "./obj";
-import { SdError } from "../errors/sd-error";
-import { bytesToHex, bytesFromHex } from "./bytes";
-import { env } from "../env";
+import { DateTime } from "../types/date-time.js";
+import { DateOnly } from "../types/date-only.js";
+import { Time } from "../types/time.js";
+import { Uuid } from "../types/uuid.js";
+import { objNullToUndefined } from "./obj.js";
+import { SdError } from "../errors/sd-error.js";
+import { bytesToHex, bytesFromHex } from "./bytes.js";
+import { env } from "../env.js";
 function jsonStringify(obj, options) {
   const seen = /* @__PURE__ */ new WeakSet();
   const convertSpecialTypes = (key, value) => {

package/dist/utils/obj.js

@@ -1,8 +1,8 @@
-import { DateTime } from "../types/date-time";
-import { DateOnly } from "../types/date-only";
-import { Time } from "../types/time";
-import { Uuid } from "../types/uuid";
-import { ArgumentError } from "../errors/argument-error";
+import { DateTime } from "../types/date-time.js";
+import { DateOnly } from "../types/date-only.js";
+import { Time } from "../types/time.js";
+import { Uuid } from "../types/uuid.js";
+import { ArgumentError } from "../errors/argument-error.js";
 function objClone(source) {
   return objCloneImpl(source);
 }

package/dist/utils/primitive.js

@@ -1,8 +1,8 @@
-import { DateTime } from "../types/date-time";
-import { DateOnly } from "../types/date-only";
-import { Time } from "../types/time";
-import { Uuid } from "../types/uuid";
-import { ArgumentError } from "../errors/argument-error";
+import { DateTime } from "../types/date-time.js";
+import { DateOnly } from "../types/date-only.js";
+import { Time } from "../types/time.js";
+import { Uuid } from "../types/uuid.js";
+import { ArgumentError } from "../errors/argument-error.js";
 function getPrimitiveTypeStr(value) {
   if (typeof value === "string") return "string";
   if (typeof value === "number") return "number";

package/dist/utils/transferable.js

@@ -1,7 +1,7 @@
-import { DateTime } from "../types/date-time";
-import { DateOnly } from "../types/date-only";
-import { Time } from "../types/time";
-import { Uuid } from "../types/uuid";
+import { DateTime } from "../types/date-time.js";
+import { DateOnly } from "../types/date-only.js";
+import { Time } from "../types/time.js";
+import { Uuid } from "../types/uuid.js";
 function transferableEncode(obj) {
   const transferList = [];
   const ancestors = /* @__PURE__ */ new Set();

package/dist/utils/wait.js

@@ -1,4 +1,4 @@
-import { TimeoutError } from "../errors/timeout-error";
+import { TimeoutError } from "../errors/timeout-error.js";
 async function waitUntil(forwarder, milliseconds, maxCount) {
   let count = 0;
   while (!await forwarder()) {

package/docs/extensions.md

@@ -0,0 +1,381 @@
+# Extensions
+
+Array, Map, Set prototype extensions. Activated by `import "@simplysm/core-common"`.
+
+## Array extension methods
+
+### Query
+
+#### single
+
+Return single element (error if 2+).
+
+```typescript
+import "@simplysm/core-common";
+
+const users = [{ id: 1, name: "Alice" }];
+users.single((u) => u.id === 1); // { id: 1, name: "Alice" }
+```
+
+#### first
+
+Return first element.
+
+```typescript
+users.first(); // { id: 1, name: "Alice" }
+```
+
+#### last
+
+Return last element.
+
+```typescript
+users.last(); // Last user
+```
+
+---
+
+### Filtering
+
+#### filterExists
+
+Remove `null`/`undefined`.
+
+```typescript
+[1, null, 2, undefined, 3].filterExists(); // [1, 2, 3]
+```
+
+#### ofType
+
+Filter by type (`PrimitiveTypeStr` or constructor).
+
+```typescript
+import "@simplysm/core-common";
+```
+
+#### filterAsync
+
+Async filter.
+
+```typescript
+import "@simplysm/core-common";
+```
+
+---
+
+### Mapping/Transformation
+
+#### mapAsync
+
+Async mapping (sequential execution).
+
+```typescript
+await ids.mapAsync(async (id) => await fetchUser(id));
+```
+
+#### mapMany
+
+flat + filterExists.
+
+```typescript
+import "@simplysm/core-common";
+```
+
+#### mapManyAsync
+
+Async mapMany.
+
+```typescript
+import "@simplysm/core-common";
+```
+
+#### parallelAsync
+
+Parallel async mapping (`Promise.all`).
+
+```typescript
+await ids.parallelAsync(async (id) => await fetchUser(id));
+```
+
+---
+
+### Grouping/Transformation
+
+#### groupBy
+
+Group by key.
+
+```typescript
+const users = [
+  { id: 1, name: "Alice", dept: "dev" },
+  { id: 2, name: "Bob", dept: "dev" },
+  { id: 3, name: "Charlie", dept: "hr" },
+];
+
+users.groupBy((u) => u.dept);
+// [{ key: "dev", values: [...] }, { key: "hr", values: [...] }]
+```
+
+#### toMap
+
+Convert to Map (error on duplicate key).
+
+```typescript
+users.toMap((u) => u.id); // Map<number, User>
+```
+
+#### toMapAsync
+
+Async Map conversion.
+
+```typescript
+import "@simplysm/core-common";
+```
+
+#### toArrayMap
+
+Convert to `Map<K, V[]>`.
+
+```typescript
+users.toArrayMap((u) => u.dept); // Map<string, User[]>
+```
+
+#### toSetMap
+
+Convert to `Map<K, Set<V>>`.
+
+```typescript
+import "@simplysm/core-common";
+```
+
+#### toMapValues
+
+Aggregate Map by group.
+
+```typescript
+import "@simplysm/core-common";
+```
+
+#### toObject
+
+Convert to `Record<string, V>`.
+
+```typescript
+import "@simplysm/core-common";
+```
+
+#### toTree
+
+Convert to tree structure.
+
+```typescript
+import "@simplysm/core-common";
+```
+
+---
+
+### Deduplication
+
+#### distinct
+
+Remove duplicates (return new array).
+
+```typescript
+[1, 2, 2, 3, 3].distinct(); // [1, 2, 3]
+```
+
+#### distinctThis
+
+Remove duplicates (modify original).
+
+```typescript
+import "@simplysm/core-common";
+```
+
+---
+
+### Sorting
+
+#### orderBy
+
+Ascending sort (return new array).
+
+```typescript
+users.orderBy((u) => u.name);
+```
+
+#### orderByDesc
+
+Descending sort (return new array).
+
+```typescript
+users.orderByDesc((u) => u.id);
+```
+
+#### orderByThis
+
+Ascending sort (modify original).
+
+```typescript
+import "@simplysm/core-common";
+```
+
+#### orderByDescThis
+
+Descending sort (modify original).
+
+```typescript
+import "@simplysm/core-common";
+```
+
+---
+
+### Comparison/Merging
+
+#### diffs
+
+Compare differences between two arrays.
+
+```typescript
+import "@simplysm/core-common";
+```
+
+#### oneWayDiffs
+
+One-way diff comparison (create/update/same).
+
+```typescript
+import "@simplysm/core-common";
+```
+
+#### merge
+
+Merge arrays.
+
+```typescript
+import "@simplysm/core-common";
+```
+
+---
+
+### Aggregation
+
+#### sum
+
+Sum.
+
+```typescript
+import "@simplysm/core-common";
+```
+
+#### min
+
+Minimum.
+
+```typescript
+import "@simplysm/core-common";
+```
+
+#### max
+
+Maximum.
+
+```typescript
+import "@simplysm/core-common";
+```
+
+---
+
+### Mutation
+
+#### insert
+
+Insert at specific position.
+
+```typescript
+import "@simplysm/core-common";
+```
+
+#### remove
+
+Remove item.
+
+```typescript
+import "@simplysm/core-common";
+```
+
+#### toggle
+
+Remove if exists, add if not.
+
+```typescript
+import "@simplysm/core-common";
+```
+
+#### clear
+
+Remove all items.
+
+```typescript
+import "@simplysm/core-common";
+```
+
+#### shuffle
+
+Shuffle (return new array).
+
+```typescript
+import "@simplysm/core-common";
+```
+
+---
+
+## Map extension methods
+
+### getOrCreate
+
+If key doesn't exist, set new value and return.
+
+```typescript
+const map = new Map<string, number[]>();
+
+// Create and return if value doesn't exist
+const arr = map.getOrCreate("key", []);
+arr.push(1);
+
+// Create with factory function (when computation is expensive)
+map.getOrCreate("key2", () => expensiveComputation());
+```
+
+### update
+
+Update value for key using function.
+
+```typescript
+const countMap = new Map<string, number>();
+countMap.update("key", (v) => (v ?? 0) + 1); // Increment counter
+```
+
+---
+
+## Set extension methods
+
+### adds
+
+Add multiple values at once.
+
+```typescript
+const set = new Set<number>([1, 2, 3]);
+set.adds(4, 5, 6); // {1, 2, 3, 4, 5, 6}
+```
+
+### toggle
+
+Toggle value (remove if exists, add if not).
+
+```typescript
+set.toggle(2);         // 2 exists so remove -> {1, 3, 4, 5, 6}
+set.toggle(7);         // 7 doesn't exist so add -> {1, 3, 4, 5, 6, 7}
+set.toggle(8, "add");  // Force add
+set.toggle(1, "del");  // Force delete
+```