@mandujs/core 0.18.20 → 0.18.22

package/src/types/branded.ts

@@ -0,0 +1,56 @@
+/**
+ * Branded Types - Nominal typing for string identifiers
+ *
+ * Prevents accidental mixing of different ID types at compile time.
+ * All branded types are structurally compatible with plain strings at runtime.
+ *
+ * @example
+ * ```typescript
+ * const col = collectionId("blog");
+ * const entry = entryId("hello-world");
+ * // col and entry are both strings at runtime,
+ * // but TypeScript treats them as distinct types.
+ * ```
+ */
+
+declare const __brand: unique symbol;
+
+/**
+ * Brand utility type - creates nominal types from structural types.
+ * The brand exists only at the type level and has zero runtime cost.
+ */
+export type Brand<T, B extends string> = T & { readonly [__brand]: B };
+
+/** Branded string identifying a content collection */
+export type CollectionId = Brand<string, "CollectionId">;
+
+/** Branded string identifying a content entry within a collection */
+export type EntryId = Brand<string, "EntryId">;
+
+/** Branded string containing sanitized HTML (XSS-safe) */
+export type SafeHTML = Brand<string, "SafeHTML">;
+
+/** Branded string identifying a route in the manifest */
+export type RouteId = Brand<string, "RouteId">;
+
+// -- Constructor functions --
+
+/** Create a branded CollectionId from a plain string */
+export function collectionId(id: string): CollectionId {
+  return id as CollectionId;
+}
+
+/** Create a branded EntryId from a plain string */
+export function entryId(id: string): EntryId {
+  return id as EntryId;
+}
+
+/** Create a branded SafeHTML from a sanitized string */
+export function safeHTML(html: string): SafeHTML {
+  return html as SafeHTML;
+}
+
+/** Create a branded RouteId from a plain string */
+export function routeId(id: string): RouteId {
+  return id as RouteId;
+}

package/src/types/index.ts

@@ -0,0 +1 @@
+export * from "./branded";

package/src/utils/hasher.test.ts

@@ -146,25 +146,25 @@ describe("normalizeForHash", () => {
       ["a", 2],
       ["m", 3],
     ]);
-    const normalized = normalizeForHash({ data: map }) as any;
+    const normalized = normalizeForHash({ data: map }) as Record<string, Record<string, unknown>>;
 
     expect(normalized.data.__type__).toBe("Map");
-    expect(normalized.data.entries[0][0]).toBe("a"); // 정렬됨
+    expect((normalized.data.entries as string[][])[0][0]).toBe("a"); // 정렬됨
   });
 
   it("should handle Set as sorted array", () => {
     const set = new Set([3, 1, 2]);
-    const normalized = normalizeForHash({ data: set }) as any;
+    const normalized = normalizeForHash({ data: set }) as Record<string, Record<string, unknown>>;
 
     expect(normalized.data.__type__).toBe("Set");
     expect(normalized.data.items).toEqual([1, 2, 3]); // 정렬됨
   });
 
   it("should detect circular references", () => {
-    const obj: any = { a: 1 };
+    const obj: Record<string, unknown> = { a: 1 };
     obj.self = obj;
 
-    const normalized = normalizeForHash(obj) as any;
+    const normalized = normalizeForHash(obj) as Record<string, unknown>;
     expect(normalized.self).toBe("__circular__");
   });
 
@@ -184,7 +184,7 @@ describe("normalizeForHash", () => {
 
   it("should normalize Error objects", () => {
     const error = new TypeError("test error");
-    const normalized = normalizeForHash({ error }) as any;
+    const normalized = normalizeForHash({ error }) as Record<string, Record<string, unknown>>;
 
     expect(normalized.error.__type__).toBe("Error");
     expect(normalized.error.name).toBe("TypeError");

package/src/utils/hasher.ts

@@ -25,7 +25,7 @@ export interface HashOptions {
   exclude?: string[];
 }
 
-export interface NormalizeOptions {
+export interface HashNormalizeOptions {
   /** 제외할 키 패턴 */
   exclude?: string[];
   /** Date를 ISO 문자열로 변환 (기본값: true) */
@@ -59,7 +59,7 @@ export interface NormalizeOptions {
  */
 export function normalizeForHash(
   value: unknown,
-  options: NormalizeOptions = {},
+  options: HashNormalizeOptions = {},
   seen: WeakSet<object> = new WeakSet()
 ): unknown {
   const {

package/src/utils/index.ts

@@ -14,7 +14,7 @@ export {
   isHashable,
   getHashInfo,
   type HashOptions,
-  type NormalizeOptions,
+  type HashNormalizeOptions,
 } from "./hasher.js";
 
 // Diff

package/src/watcher/watcher.ts

@@ -157,8 +157,8 @@ export class FileWatcher {
       this.processFileEvent("delete", filePath);
     });
 
-    this.chokidarWatcher.on("error", (error) => {
-      console.error(`[Watch] Error:`, error.message);
+    this.chokidarWatcher.on("error", (error: unknown) => {
+      console.error(`[Watch] Error:`, error instanceof Error ? error.message : String(error));
     });
 
     this._active = true;