@iyulab/enterprise 0.9.1 → 0.10.1

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## 0.10.1
+
+### Added
+
+- **`ODataService` gained `apiPut<T>(path, body?)`.** The other three custom-REST verbs
+  (`apiGet`/`apiPost`/`apiPatch`/`apiDelete`) were already there; `PUT` was the one missing member
+  of that set, even though the underlying `@iyulab/http-client` `HttpClient` has always had `.put()`.
+  A consumer whose backend models "replace this resource" as `PUT` had no way to reach it through
+  this wrapper. Passing a `FormData` body to `apiPost`/`apiPut`/`apiPatch` already worked before this
+  change and needed no fix — `HttpClient` never forces JSON serialization on it and lets the browser
+  set the multipart boundary itself.
+
+## 0.10.0
+
+### Changed
+
+- **`ProgressHelper.validateProgress`/`ratioToPercent` now return `number | null` instead of
+  folding a missing input into `0`.** "No value yet" and "0% progress" are different facts and
+  were rendering identically. A call site that already narrows its input to a definite `number`
+  keeps getting a definite `number` back (an overload preserves this); a call site that may pass
+  `null`/`undefined` now has to handle a `null` result explicitly.
+- **`CurrencyHelper.formatCurrency`, `DateHelper.formatDate`/`formatLocalDate`/`formatDateTime`,
+  and `UrgencyHelper.formatDaysRemaining` now render a missing value as an em dash (`—`) instead
+  of a hyphen (`-`).** The two glyphs looked almost identical but meant different things; the
+  empty-value string is now one shared constant (`EMPTY_VALUE_DISPLAY`, exported from
+  `@iyulab/enterprise`) instead of eight independent hardcoded literals across the four helpers.
+
 ## 0.9.1
 
 ### Fixed

package/README.md

@@ -95,9 +95,21 @@ export const svc = createODataService({
 
 await svc.odataGet<Order>('Orders', { $top: '20' })   // value 배열 언랩
 await svc.odataPost<Order>('Orders', { name: 'A', note: '' })  // '' → null 정규화 + 성공 토스트
-await svc.apiDelete('orders/7')                        // 204 안전
 svc.odataUrl('Orders')                                 // flex-table useODataSource 엔드포인트
 svc.sourceDefaults                                     // { baseUrl, onUnauthorized } 주입용
+
+// custom REST — GET/POST/PUT/PATCH/DELETE 전부, 204 빈 바디 안전 파싱 포함
+await svc.apiGet<Order>('reports/summary')
+await svc.apiPost<Order>('orders', { name: 'A' })
+await svc.apiPut<Order>('orders/7', { name: 'A (revised)' })    // 리소스 전체 교체
+await svc.apiPatch<Order>('orders/7', { note: 'urgent' })
+await svc.apiDelete('orders/7')                                 // 204 안전
+
+// body가 FormData 인스턴스면 그대로(직렬화 없이) 멀티파트로 전송된다 —
+// Content-Type은 브라우저가 boundary와 함께 자동 설정한다. apiPost/apiPut/apiPatch 전부 동일.
+const form = new FormData()
+form.append('file', file)
+await svc.apiPost<Order>('orders/7/attachments', form)
 ```
 
 주입 항목:

package/dist/data/ODataService.d.ts

@@ -73,9 +73,13 @@ export interface ODataService {
     odataDelete(entity: string, id: string): Promise<void>;
     /** custom REST GET — 204 등 빈 바디를 안전 파싱. */
     apiGet<T>(path: string): Promise<T>;
-    /** custom REST POST. */
+    /** custom REST POST. `body`가 `FormData` 인스턴스면 그대로(직렬화 없이) 멀티파트로
+     *  전송된다 — `@iyulab/http-client`가 Content-Type을 브라우저 자동 설정에 맡기고
+     *  JSON 직렬화 분기를 타지 않는다. `apiPut`/`apiPatch`도 동일하게 동작한다. */
     apiPost<T>(path: string, body?: unknown): Promise<T>;
-    /** custom REST PATCH. */
+    /** custom REST PUT(리소스 전체 교체/생성). `body`의 `FormData` 처리는 `apiPost` 참조. */
+    apiPut<T>(path: string, body?: unknown): Promise<T>;
+    /** custom REST PATCH. `body`의 `FormData` 처리는 `apiPost` 참조. */
     apiPatch<T>(path: string, body?: unknown): Promise<T>;
     /** custom REST DELETE — 대부분 204 No Content. */
     apiDelete<T = void>(path: string): Promise<T>;

package/dist/helpers/ProgressHelper.d.ts

@@ -12,17 +12,23 @@ export declare class ProgressHelper {
         medium?: number;
     }): string;
     /**
-     * Validate and clamp progress to 0-100 range
+     * Validate and clamp progress to 0-100 range.
+     *
+     * Returns `null` for a missing/unparsable input rather than `0` — "no progress value yet"
+     * and "0% progress" are different facts and must not render identically.
      * @param progress - Raw progress value
      * @param round - Whether to round to integer (default: true)
      */
-    static validateProgress(progress: number | null | undefined, round?: boolean): number;
+    static validateProgress(progress: number, round?: boolean): number;
+    static validateProgress(progress: number | null | undefined, round?: boolean): number | null;
     /**
-     * Convert decimal ratio to percentage
+     * Convert decimal ratio to percentage.
+     *
+     * Returns `null` for a missing/unparsable input — see {@link validateProgress}.
      * @param ratio - Decimal ratio (0-1)
      * @param round - Whether to round to integer
      */
-    static ratioToPercent(ratio: number | null | undefined, round?: boolean): number;
+    static ratioToPercent(ratio: number | null | undefined, round?: boolean): number | null;
     /**
      * Get progress label text
      * @param progress - Progress value (0-100)

package/dist/helpers/constants.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Display string for an absent value (`null`/`undefined`/unparsable), shared by every
+ * formatting helper in this package so "no value" renders identically everywhere and
+ * never collides with a real `0`.
+ */
+export declare const EMPTY_VALUE_DISPLAY = "\u2014";

package/dist/helpers/index.d.ts

@@ -3,6 +3,7 @@
  * Reusable utility classes for enterprise applications
  */
 export * from './messages';
+export * from './constants';
 export * from './CurrencyHelper';
 export * from './DateHelper';
 export * from './ProgressHelper';

package/dist/index.js

@@ -117,6 +117,14 @@ messages.register("ko", {
 	daysRemaining: "{days}일"
 });
 //#endregion
+//#region src/helpers/constants.ts
+/**
+* Display string for an absent value (`null`/`undefined`/unparsable), shared by every
+* formatting helper in this package so "no value" renders identically everywhere and
+* never collides with a real `0`.
+*/
+var EMPTY_VALUE_DISPLAY = "—";
+//#endregion
 //#region src/helpers/CurrencyHelper.ts
 /**
 * Currency formatting utility class.
@@ -135,7 +143,7 @@ var CurrencyHelper = class {
 	* @param locale - Locale for formatting (default: 'ko-KR')
 	*/
 	static formatCurrency(amount, currency = "KRW", locale = "ko-KR") {
-		if (amount === null || amount === void 0) return "-";
+		if (amount === null || amount === void 0) return "—";
 		return formatCurrency(amount, currency, {
 			minimumFractionDigits: 0,
 			maximumFractionDigits: currency === "KRW" ? 0 : 2
@@ -182,9 +190,9 @@ var DateHelper = class {
 	* @param date - Date to format (Date object or ISO string)
 	*/
 	static formatDate(date) {
-		if (!date) return "-";
+		if (!date) return "—";
 		const d = typeof date === "string" ? new Date(date) : date;
-		if (isNaN(d.getTime())) return "-";
+		if (isNaN(d.getTime())) return "—";
 		return d.toISOString().slice(0, 10);
 	}
 	/**
@@ -194,9 +202,9 @@ var DateHelper = class {
 	* @param options - Intl.DateTimeFormat options
 	*/
 	static formatLocalDate(date, locale = "ko-KR", options) {
-		if (!date) return "-";
+		if (!date) return "—";
 		const d = typeof date === "string" ? new Date(date) : date;
-		if (isNaN(d.getTime())) return "-";
+		if (isNaN(d.getTime())) return "—";
 		return d.toLocaleDateString(locale, options || {
 			year: "numeric",
 			month: "2-digit",
@@ -208,9 +216,9 @@ var DateHelper = class {
 	* @param date - Date to format
 	*/
 	static formatDateTime(date) {
-		if (!date) return "-";
+		if (!date) return "—";
 		const d = typeof date === "string" ? new Date(date) : date;
-		if (isNaN(d.getTime())) return "-";
+		if (isNaN(d.getTime())) return "—";
 		return d.toISOString().slice(0, 16).replace("T", " ");
 	}
 	/**
@@ -299,25 +307,22 @@ var ProgressHelper = class {
 		if (progress >= medium) return "#FF9800";
 		return "#F44336";
 	}
-	/**
-	* Validate and clamp progress to 0-100 range
-	* @param progress - Raw progress value
-	* @param round - Whether to round to integer (default: true)
-	*/
 	static validateProgress(progress, round = true) {
-		if (progress === null || progress === void 0 || isNaN(progress)) return 0;
+		if (progress === null || progress === void 0 || isNaN(progress)) return null;
 		let value = progress;
 		if (value < 0) value = 0;
 		if (value > 100) value = 100;
 		return round ? Math.round(value) : value;
 	}
 	/**
-	* Convert decimal ratio to percentage
+	* Convert decimal ratio to percentage.
+	*
+	* Returns `null` for a missing/unparsable input — see {@link validateProgress}.
 	* @param ratio - Decimal ratio (0-1)
 	* @param round - Whether to round to integer
 	*/
 	static ratioToPercent(ratio, round = true) {
-		if (ratio === null || ratio === void 0 || isNaN(ratio)) return 0;
+		if (ratio === null || ratio === void 0 || isNaN(ratio)) return null;
 		const percent = ratio * 100;
 		return this.validateProgress(percent, round);
 	}
@@ -452,7 +457,7 @@ var UrgencyHelper = class {
 	* @param daysRemaining - Days until deadline
 	*/
 	static formatDaysRemaining(daysRemaining) {
-		if (daysRemaining === null || daysRemaining === void 0) return "-";
+		if (daysRemaining === null || daysRemaining === void 0) return "—";
 		if (daysRemaining < 0) return messages.text("daysOverdue", { days: Math.abs(daysRemaining) });
 		if (daysRemaining === 0) return messages.text("daysToday");
 		return messages.text("daysRemaining", { days: daysRemaining });
@@ -769,6 +774,11 @@ function createODataService(config) {
 		await throwIfError(res);
 		return parseJsonBody(res);
 	}
+	async function apiPut(path, body) {
+		const res = await client.put(apiUrl(path), body ?? {});
+		await throwIfError(res);
+		return parseJsonBody(res);
+	}
 	async function apiPatch(path, body) {
 		const res = await client.patch(apiUrl(path), body ?? {});
 		await throwIfError(res);
@@ -796,6 +806,7 @@ function createODataService(config) {
 		odataDelete,
 		apiGet,
 		apiPost,
+		apiPut,
 		apiPatch,
 		apiDelete,
 		fetchRaw,
@@ -977,4 +988,4 @@ function createAuthClient(config) {
 	};
 }
 //#endregion
-export { ApiConfig, ApiError, CurrencyHelper, DateHelper, FormRow, FormSection, ProgressHelper, UrgencyHelper, clearPermissions, createAuthClient, createODataService, createPermissionStore, defaultPermissionStore, getPermissions, hasAllPermissions, hasAnyPermission, hasPermission, messages, setPermissions };
+export { ApiConfig, ApiError, CurrencyHelper, DateHelper, EMPTY_VALUE_DISPLAY, FormRow, FormSection, ProgressHelper, UrgencyHelper, clearPermissions, createAuthClient, createODataService, createPermissionStore, defaultPermissionStore, getPermissions, hasAllPermissions, hasAnyPermission, hasPermission, messages, setPermissions };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iyulab/enterprise",
-  "version": "0.9.1",
+  "version": "0.10.1",
   "description": "Enterprise utilities and components for iyulab framework",
   "keywords": [
     "enterprise",