@iyulab/enterprise 0.13.0 → 0.15.0

package/dist/index.js

@@ -741,109 +741,138 @@ function createODataService(config) {
 			details
 		};
 	}
-	/** 에러 확인 후 throw. 401 은 onUnauthorized 통지 후 세션 만료 에러로 단락. */
-	async function throwIfError(res) {
+	/**
+	* 에러 확인 후 throw. 401 은 기본적으로 `onUnauthorized` 통지 후 세션 만료 에러로 단락한다.
+	*
+	* ⚠`opts.onUnauthorized === false` 면 그 단락을 건너뛰고 **다른 상태 코드와 똑같이** 다룬다 —
+	* 훅도 부르지 않고 메시지도 덮어쓰지 않는다(`ODataRequestOptions.onUnauthorized` 참조).
+	*/
+	async function throwIfError(res, opts) {
 		if (res.ok) return;
-		if (res.status === 401) {
+		if (res.status === 401 && opts?.onUnauthorized !== false) {
 			config.onUnauthorized?.(401);
 			throw new ApiError(messages.sessionExpired, 401);
 		}
 		const { message, details } = await extractErrorInfo(res);
 		throw new ApiError(message, res.status, details);
 	}
-	async function odataGet(entity, params) {
+	async function odataGet(entity, params, opts) {
 		const u = new URL(odataUrl(entity));
 		if (params) for (const [k, v] of Object.entries(params)) u.searchParams.set(k, v);
 		const res = await client.get(u.toString());
-		await throwIfError(res);
+		await throwIfError(res, opts);
 		const json = await res.json();
 		return json.value ?? json;
 	}
-	async function odataGetById(entity, id) {
+	async function odataGetById(entity, id, opts) {
 		const res = await client.get(`${odataUrl(entity)}(${id})`);
-		await throwIfError(res);
+		await throwIfError(res, opts);
 		return res.json();
 	}
-	async function odataCount(entity, filter) {
+	async function odataCount(entity, filter, opts) {
 		const qs = buildQuery({
 			filter,
 			top: 0,
 			count: true
 		});
 		const res = await client.get(`${odataUrl(entity)}${qs}`);
-		await throwIfError(res);
+		await throwIfError(res, opts);
 		return (await res.json())["@odata.count"] ?? 0;
 	}
-	async function odataPostQuiet(entity, body) {
-		const res = await client.post(odataUrl(entity), normalizeBody(body));
-		await throwIfError(res);
-		return res.json();
-	}
-	async function odataPost(entity, body) {
+	/**
+	* 쓰기 실패를 사용자에게 알린 뒤 그대로 다시 던진다.
+	*
+	* 🔴**이 서비스의 통지 축은 «쓰기 ↔ 읽기» 이지 «odata ↔ api» 가 아니다.** 조회
+	* (`odataGet`·`odataGetById`·`odataCount`·`apiGet`·`fetchRaw`)는 어느 쪽도 통지하지
+	* 않는다 — 화면이 비어 있는 것 자체가 신호이고, 목록 조회마다 토스트를 띄우면 읽을 수
+	* 없다. 쓰기는 **결과가 화면에 안 보일 수 있으므로** 통지한다: 서버가 409 와 사유를
+	* 돌려줘도 아무 일도 일어나지 않은 화면과 구별되지 않는다.
+	*
+	* ⚠**401 은 제외한다** — `onUnauthorized` 가 이미 안내하므로 토스트가 겹친다.
+	*
+	* ⚠성공 토스트는 **`odata*` 쓰기에만** 있다. `api*` 는 임의의 RPC(상태 전이·발행·업로드)를
+	* 태우는 경로라 «저장되었습니다» 같은 문구를 우리가 지어낼 수 없다 — 실패 메시지는 서버가
+	* 주므로 어느 엔드포인트에서나 뜻이 통하지만, 성공 문구는 그렇지 않다.
+	*/
+	async function notifyingWrite(run) {
 		try {
-			const result = await odataPostQuiet(entity, body);
-			notifySuccess?.(messages.saved);
-			return result;
+			return await run();
 		} catch (e) {
 			if (!(e instanceof ApiError && e.status === 401)) notifyError?.(e instanceof Error ? e.message : messages.requestFailed);
 			throw e;
 		}
 	}
-	async function odataPatchQuiet(entity, id, body) {
-		await throwIfError(await client.patch(`${odataUrl(entity)}(${id})`, normalizeBody(body)));
+	async function odataPostQuiet(entity, body, opts) {
+		const res = await client.post(odataUrl(entity), normalizeBody(body));
+		await throwIfError(res, opts);
+		return res.json();
 	}
-	async function odataPatch(entity, id, body) {
-		try {
-			await odataPatchQuiet(entity, id, body);
+	async function odataPost(entity, body, opts) {
+		return notifyingWrite(async () => {
+			const result = await odataPostQuiet(entity, body, opts);
+			notifySuccess?.(messages.saved);
+			return result;
+		});
+	}
+	async function odataPatchQuiet(entity, id, body, opts) {
+		await throwIfError(await client.patch(`${odataUrl(entity)}(${id})`, normalizeBody(body)), opts);
+	}
+	async function odataPatch(entity, id, body, opts) {
+		return notifyingWrite(async () => {
+			await odataPatchQuiet(entity, id, body, opts);
 			notifySuccess?.(messages.updated);
-		} catch (e) {
-			if (!(e instanceof ApiError && e.status === 401)) notifyError?.(e instanceof Error ? e.message : messages.requestFailed);
-			throw e;
-		}
+		});
 	}
-	async function odataDeleteQuiet(entity, id) {
-		await throwIfError(await client.delete(`${odataUrl(entity)}(${id})`));
+	async function odataDeleteQuiet(entity, id, opts) {
+		await throwIfError(await client.delete(`${odataUrl(entity)}(${id})`), opts);
 	}
-	async function odataDelete(entity, id) {
-		try {
-			await odataDeleteQuiet(entity, id);
+	async function odataDelete(entity, id, opts) {
+		return notifyingWrite(async () => {
+			await odataDeleteQuiet(entity, id, opts);
 			notifySuccess?.(messages.deleted);
-		} catch (e) {
-			if (!(e instanceof ApiError && e.status === 401)) notifyError?.(e instanceof Error ? e.message : messages.requestFailed);
-			throw e;
-		}
+		});
 	}
-	async function apiGet(path) {
+	async function apiGet(path, opts) {
 		const [p, ...q] = path.split("?");
 		const url = q.length ? `${apiUrl(p)}?${q.join("?")}` : apiUrl(p);
 		const res = await client.get(url);
-		await throwIfError(res);
+		await throwIfError(res, opts);
 		return parseJsonBody(res);
 	}
-	async function apiPost(path, body) {
+	async function apiPostQuiet(path, body, opts) {
 		const res = await client.post(apiUrl(path), body ?? {});
-		await throwIfError(res);
+		await throwIfError(res, opts);
 		return parseJsonBody(res);
 	}
-	async function apiPut(path, body) {
+	async function apiPost(path, body, opts) {
+		return notifyingWrite(() => apiPostQuiet(path, body, opts));
+	}
+	async function apiPutQuiet(path, body, opts) {
 		const res = await client.put(apiUrl(path), body ?? {});
-		await throwIfError(res);
+		await throwIfError(res, opts);
 		return parseJsonBody(res);
 	}
-	async function apiPatch(path, body) {
+	async function apiPut(path, body, opts) {
+		return notifyingWrite(() => apiPutQuiet(path, body, opts));
+	}
+	async function apiPatchQuiet(path, body, opts) {
 		const res = await client.patch(apiUrl(path), body ?? {});
-		await throwIfError(res);
+		await throwIfError(res, opts);
 		return parseJsonBody(res);
 	}
-	async function apiDelete(path) {
+	async function apiPatch(path, body, opts) {
+		return notifyingWrite(() => apiPatchQuiet(path, body, opts));
+	}
+	async function apiDeleteQuiet(path, opts) {
 		const res = await client.delete(apiUrl(path));
-		await throwIfError(res);
+		await throwIfError(res, opts);
 		return parseJsonBody(res);
 	}
+	async function apiDelete(path, opts) {
+		return notifyingWrite(() => apiDeleteQuiet(path, opts));
+	}
 	async function fetchRaw(url) {
-		const res = await client.get(url);
-		await throwIfError(res);
-		return res;
+		return client.get(url);
 	}
 	return {
 		odataUrl,
@@ -859,9 +888,13 @@ function createODataService(config) {
 		odataDelete,
 		apiGet,
 		apiPost,
+		apiPostQuiet,
 		apiPut,
+		apiPutQuiet,
 		apiPatch,
+		apiPatchQuiet,
 		apiDelete,
+		apiDeleteQuiet,
 		fetchRaw,
 		sourceDefaults: {
 			baseUrl,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iyulab/enterprise",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "description": "Enterprise utilities and components for iyulab framework",
   "keywords": [
     "enterprise",
@@ -56,12 +56,13 @@
   },
   "devDependencies": {
     "@iyulab/components": "^1.27.0",
+    "@microsoft/api-extractor": "^7.58.8",
     "@types/node": "^26.1.1",
     "@types/react": "^19.2.14",
     "typescript": "^6.0.2",
     "vite": "^8.1.4",
     "vite-plugin-dts": "^5.0.3",
-    "vitest": "^4.1.10"
+    "vitest": "^5.0.0"
   },
   "peerDependencies": {
     "react": ">=18",

package/dist/ApiConfig.d.ts

@@ -1,71 +0,0 @@
-/**
- * API configuration and environment-based endpoint management
- *
- * Supports both development (proxy) and production (same-origin) deployments
- */
-export interface ApiConfigOptions {
-    /** Base URL for all API requests (default: '') */
-    baseUrl?: string;
-    /** OData endpoint prefix (default: '$data') */
-    odataPrefix?: string;
-    /** REST API endpoint prefix (default: 'api') */
-    apiPrefix?: string;
-    /** Force development mode detection */
-    isDevelopment?: boolean;
-}
-export declare class ApiConfig {
-    private static _baseUrl;
-    private static _odataPrefix;
-    private static _apiPrefix;
-    private static _isDevelopment;
-    /**
-     * Initialize API configuration
-     * @param options Configuration options
-     */
-    static initialize(options?: ApiConfigOptions): void;
-    /**
-     * API Base URL (always relative path by default)
-     */
-    static get baseUrl(): string;
-    /**
-     * Manually set Base URL (for testing or custom configurations)
-     */
-    static setBaseUrl(url: string): void;
-    /**
-     * OData endpoint prefix
-     */
-    static get odataPrefix(): string;
-    /**
-     * REST API endpoint prefix
-     */
-    static get apiPrefix(): string;
-    /**
-     * Generate OData endpoint URL
-     * @param entityName Entity name for OData endpoint
-     */
-    static getODataUrl(entityName: string): string;
-    /**
-     * Generate REST API endpoint URL
-     * @param endpoint API endpoint path
-     */
-    static getApiUrl(endpoint: string): string;
-    /**
-     * Generate full URL with query parameters
-     * @param endpoint Endpoint path
-     * @param params Query parameters
-     */
-    static getUrlWithParams(endpoint: string, params: Record<string, string | number | boolean | undefined>): string;
-    /**
-     * Check if running in development environment
-     * Tries to detect from various bundler environments
-     */
-    static get isDevelopment(): boolean;
-    /**
-     * Check if running in production environment
-     */
-    static get isProduction(): boolean;
-    /**
-     * Reset configuration to defaults
-     */
-    static reset(): void;
-}

package/dist/FormRow.d.ts

@@ -1,33 +0,0 @@
-import { CSSProperties, ReactNode } from 'react';
-/**
- * L2 폼 행 — 기본 2열, `full` 이면 1열.
- *
- * 오버라이드 계약(docs/lob-layers.md §2)에 따라 `className`·`style` 을 받아 병합한다.
- * `columns` 는 2열 고정이 맞지 않는 소비자가 **컴포넌트를 복제하지 않고** 조정하는 경로다
- * — 복제가 시작되면 이 계층은 쓰기 전보다 나쁜 상태를 만든다.
- *
- * 🔴**트랙은 `minmax(0, 1fr)` 이지 `1fr` 이 아니다 — 순수 `1fr` 은 «균등» 을 약속하고**
- * **지키지 않는다.** 그리드 아이템의 기본 `min-width: auto` 는 내용의 min-content 아래로
- * 줄어들기를 거부하므로, 한 칸에 긴 내용이 들어오면 그 칸만 부풀고 나머지가 찌그러진다.
- * 실측(400px 컨테이너 · 한 칸에 긴 불가분 문자열): 2열이 **425/8**, 3열이 **425/8/8** 이었고
- * 행 자체가 컨테이너를 넘쳤다. `minmax(0, 1fr)` 은 트랙의 최소를 0 으로 만들어 **자식을**
- * **건드리지 않고** 이를 고친다 — 같은 실측에서 **196/196** · **128/128/128**.
- *
- * ⚠**긴 불가분 내용 자체의 넘침은 별개 축이고 이 컴포넌트의 몫이 아니다.** 칸이 균등해져도
- * 그 안의 긴 문자열은 여전히 자기 칸을 넘는다 — 그것은 셀의 `overflow-wrap` 이 답이다
- * (`@iyulab/components` 의 엘리먼트는 이미 그 값을 갖는다). 같은 실측에서 `overflow-wrap` 을
- * 주면 행의 넘침이 0 이 됐다.
- *
- * 계약은 `tests/form-layout-contract.test.ts` 가 고정한다 — 다만 그 파일은 **«선언» 을 재지**
- * **«배치» 를 재지 않는다**(이 패키지엔 레이아웃을 계산하는 테스트 자리가 없다). 위 수치는
- * 형제 패키지의 브라우저 프로젝트를 계측기로 빌린 일회성 탐침으로 쟀다.
- */
-export declare function FormRow({ children, full, columns, className, style, }: {
-    children: ReactNode;
-    /** 한 행 전체를 한 칸으로 쓴다. `columns` 보다 우선한다. */
-    full?: boolean;
-    /** 열 수. 기본 2. */
-    columns?: number;
-    className?: string;
-    style?: CSSProperties;
-}): import("react").JSX.Element;

package/dist/FormSection.d.ts

@@ -1,26 +0,0 @@
-import { CSSProperties, ReactNode } from 'react';
-/**
- * L2 폼 블록 — 제목이 붙은 필드 묶음.
- *
- * 🔴**제목에 `text-transform: uppercase` 와 `letter-spacing` 을 걸지 않는다**(0.7.0 에서 제거).
- *   ⑴ 한글에는 대문자가 없어 `uppercase` 가 **아무 효과가 없고**, 제목에 영문이 섞이면
- *      그것만 커져 오히려 어수선해진다.
- *   ⑵ 양수 `letter-spacing` 은 **한글 가독성을 떨어뜨린다** — 라틴 소문자 조판 관례를
- *      그대로 옮기면 안 되는 자리다.
- *   ⇒ 위계는 **크기·굵기·색** 세 신호로만 만든다(타입 스케일의 `label` 단).
- *   영문 전용 UI 에서 눈썹 텍스트 느낌이 필요하면 `titleStyle` 로 `--u-text-overline-*`
- *   단을 직접 지정한다 — 그 단은 영문·숫자 라벨을 전제하고 양수 자간을 갖는다.
- *
- * 오버라이드 계약(docs/lob-layers.md §2): 구조는 두고 **children 치환 + prop** 으로 바꾼다.
- * ⚠기본 스타일은 병합 가능한 형태로만 둔다 — 호출자의 `style` 이 뒤에 오므로 필요한
- * 항목만 골라 덮을 수 있다. 인라인으로 굳혀 두면 소비자 CSS 가 이길 수 없어(`!important`
- * 외) 계약이 원천적으로 무효가 된다.
- */
-export declare function FormSection({ title, children, className, style, titleStyle, }: {
-    title: ReactNode;
-    children: ReactNode;
-    className?: string;
-    style?: CSSProperties;
-    /** 제목 줄만 따로 조정할 때. 블록을 통째로 갈아엎지 않기 위한 훅이다. */
-    titleStyle?: CSSProperties;
-}): import("react").JSX.Element;

package/dist/auth/AuthClient.d.ts

@@ -1,46 +0,0 @@
-import { PermissionStore } from './permissions';
-export interface AuthClientMessages {
-    /** 401 로그인 실패 */
-    invalidCredentials: string;
-    /** 기타 로그인 실패(non-401) 폴백 */
-    loginFailed: string;
-    /** 네트워크/예외 */
-    networkError: string;
-}
-export interface LoginResult<TUser> {
-    ok: boolean;
-    user?: TUser;
-    message?: string;
-}
-export interface AuthClientConfig<TUser> {
-    /** 현재 세션 조회 URL (GET) */
-    meUrl: string;
-    /** 로그인 URL (POST, 자격증명을 JSON 바디로) */
-    loginUrl: string;
-    /** 로그아웃 URL (POST) */
-    logoutUrl: string;
-    /** 상대 URL 앞에 붙일 오리진(기본 '' = same-origin). */
-    baseUrl?: string;
-    /** fetch credentials 모드(기본 'same-origin' — 쿠키 세션). */
-    credentials?: RequestCredentials;
-    /** 사용자 대면 문구(로케일). 기본 영어. */
-    messages?: Partial<AuthClientMessages>;
-    /** 로그인 실패(non-401) 응답 바디에서 서버 메시지 추출. 기본: `body.Message ?? body.message`. */
-    extractLoginError?: (body: unknown) => string | undefined;
-    /**
-     * user 에서 권한 코드 배열을 추출. 지정하면 `fetchMe`/`login` 성공 시 권한 store 를 자동 갱신,
-     * `fetchMe`→null / `logout` 시 자동 clear.
-     */
-    getPermissions?: (user: TUser) => string[];
-    /** 권한 자동 갱신 대상 store(기본: `defaultPermissionStore`). */
-    permissionStore?: PermissionStore;
-}
-export interface AuthClient<TUser, TCredentials> {
-    /** 현재 세션 조회. 미인증/세션 만료 시 `null`. 성공 시 권한 store 자동 갱신(getPermissions 지정 시). */
-    fetchMe(): Promise<TUser | null>;
-    /** 로그인. 성공 시 권한 store 자동 갱신(getPermissions 지정 시). */
-    login(credentials: TCredentials): Promise<LoginResult<TUser>>;
-    /** 로그아웃. 권한 store 자동 clear(getPermissions 지정 시). */
-    logout(): Promise<void>;
-}
-export declare function createAuthClient<TUser, TCredentials = Record<string, unknown>>(config: AuthClientConfig<TUser>): AuthClient<TUser, TCredentials>;

package/dist/auth/permissions.d.ts

@@ -1,43 +0,0 @@
-/**
- * 권한 스냅샷 store — 부팅 시점의 현재 사용자 권한 코드 집합을 보관하고
- * `hasPermission`/`hasAny`/`hasAll` 판정을 제공한다. 프레임워크 무관(React·Lit 공통)이며
- * 권한 코드는 **불투명 문자열**로만 다룬다(도메인 의미는 앱이 소유).
- *
- * 부팅 시점 스냅샷 모델 — 권한 변경은 다음 로그인(재-set)까지 반영되지 않는다. 단일 운영자
- * 모델에 충분하며, 실시간 권한 회수/멀티테넌트가 필요하면 `subscribe` 로 반응형 확장 가능.
- */
-export interface PermissionStore {
-    /** 현재 권한 집합을 통째로 교체한다(로그인/세션 조회 성공 시). */
-    set(codes: Iterable<string>): void;
-    /** 현재 권한 집합(읽기 전용). */
-    get(): ReadonlySet<string>;
-    /** 단일 권한 코드 보유 여부. */
-    has(code: string): boolean;
-    /** 주어진 코드 중 하나라도 보유. 빈 목록은 `true`(제약 없음). */
-    hasAny(codes: Iterable<string>): boolean;
-    /** 주어진 코드를 모두 보유. 빈 목록은 `true`. */
-    hasAll(codes: Iterable<string>): boolean;
-    /** 권한을 비운다(로그아웃/세션 만료 시). */
-    clear(): void;
-    /** 권한 변경 구독. 해제 함수를 반환한다. */
-    subscribe(listener: (codes: ReadonlySet<string>) => void): () => void;
-}
-/** 독립적인 권한 store 를 생성한다(테스트 격리·다중 컨텍스트에 유리). */
-export declare function createPermissionStore(initial?: Iterable<string>): PermissionStore;
-/**
- * 기본 싱글톤 권한 store. 앱 전역에서 `hasPermission(code)` 를 어디서나 호출하는
- * 흔한 패턴을 위해 free 함수로 바인딩해 노출한다. 격리가 필요하면 `createPermissionStore()` 를 쓴다.
- */
-export declare const defaultPermissionStore: PermissionStore;
-/** 기본 store 의 권한을 교체한다(부팅 시 `setPermissions(user.Permissions)`). */
-export declare const setPermissions: (codes: Iterable<string>) => void;
-/** 기본 store 의 현재 권한 집합. */
-export declare const getPermissions: () => ReadonlySet<string>;
-/** 기본 store 기준 단일 권한 보유 여부. */
-export declare const hasPermission: (code: string) => boolean;
-/** 기본 store 기준 하나라도 보유. */
-export declare const hasAnyPermission: (codes: Iterable<string>) => boolean;
-/** 기본 store 기준 모두 보유. */
-export declare const hasAllPermissions: (codes: Iterable<string>) => boolean;
-/** 기본 store 권한을 비운다. */
-export declare const clearPermissions: () => void;

package/dist/data/ODataService.d.ts

@@ -1,124 +0,0 @@
-import { HttpResponse } from '@iyulab/http-client';
-/**
- * OData v4 오류 봉투의 `error.details` 항목 — 필드별 검증 실패 상세.
- *
- * 규격(OData JSON Format v4.0)상 각 항목은 `code`/`message` 를 **반드시** 갖고
- * `target`(오류가 난 속성 이름)은 **선택**이다 — 필수로 선언하면 target 을 생략한
- * 서버 응답에서 타입이 거짓말을 하게 된다.
- */
-export interface ApiErrorDetail {
-    code: string;
-    message: string;
-    target?: string;
-}
-/**
- * API 호출 실패 에러 — HTTP status 를 실어 호출부가 상태별 분기(예: 404 도메인 문구)를 할 수 있게 한다.
- * `Error` 를 상속하므로 기존 `e instanceof Error`/`e.message` 소비처는 그대로 동작한다.
- */
-export declare class ApiError extends Error {
-    readonly status: number;
-    /** OData v4 오류 봉투의 `error.details`(필드별 검증 상세) — 서버 응답에 없거나 파싱 실패면 undefined. */
-    readonly details?: ApiErrorDetail[];
-    constructor(message: string, status: number, details?: ApiErrorDetail[]);
-}
-/** 서비스가 토스트/에러에 쓰는 사용자 대면 문구. 기본값은 영어 — 앱이 로케일별로 오버라이드한다. */
-export interface ODataServiceMessages {
-    /** POST 성공 토스트 */
-    saved: string;
-    /** PATCH 성공 토스트 */
-    updated: string;
-    /** DELETE 성공 토스트 */
-    deleted: string;
-    /** 401 세션 만료 시 throw 되는 에러 메시지 */
-    sessionExpired: string;
-    /** status별 매핑이 없을 때의 폴백 */
-    requestFailed: string;
-    /** 서버 raw 메시지가 없거나 너무 길 때 status → 친화 메시지 */
-    http: Record<number, string>;
-}
-export interface ODataServiceConfig {
-    /** 모든 요청의 베이스 URL (예: `window.location.origin`). 슬래시 없이 오리진만. */
-    baseUrl: string;
-    /** OData 엔드포인트 prefix (기본 `$data`) */
-    odataPrefix?: string;
-    /** custom REST 엔드포인트 prefix (기본 `api`) */
-    apiPrefix?: string;
-    /**
-     * 401 응답 시 호출된다(모든 메서드 공통). 세션 만료 리다이렉트는 앱이 결정한다.
-     * 재진입 가드(한 번만 리다이렉트)도 앱 콜백 쪽에서 처리한다 — 라이브러리는 status만 통지.
-     */
-    onUnauthorized?: (status: number) => void;
-    /** 성공/실패 토스트 훅. 생략하면 토스트를 내지 않는다(순수 · 테스트 용이). */
-    notify?: {
-        success?: (message: string) => void;
-        error?: (message: string) => void;
-    };
-    /** 사용자 대면 문구 오버라이드(로케일). 지정한 키만 기본값을 대체한다. */
-    messages?: Partial<ODataServiceMessages>;
-    /**
-     * 에러 메시지 포매팅 오버라이드. 반환값이 있으면 그것을 에러 메시지로 사용한다.
-     * (앱별 정책 — 예: 영문 raw OData 메시지를 로케일 친화 문구로 치환 — 을 여기에 둔다.)
-     */
-    formatError?: (info: {
-        status: number;
-        statusText: string;
-        rawMessage?: string;
-        /** OData v4 `error.details` — 검증을 마친 항목만 실린다(`ApiError.details` 와 같은 값). */
-        details?: ApiErrorDetail[];
-        body?: unknown;
-    }) => string | undefined;
-}
-export interface ODataService {
-    /** 설정된 prefix + baseUrl 로 OData 엔티티 URL 을 만든다(flex-table useODataSource 등에서 사용). */
-    odataUrl(entity: string): string;
-    /** 설정된 prefix + baseUrl 로 REST 엔드포인트 URL 을 만든다. */
-    apiUrl(path: string): string;
-    /** OData GET(목록). `value` 배열을 벗겨 반환한다. */
-    odataGet<T>(entity: string, params?: Record<string, string>): Promise<T[]>;
-    /** OData GET(단건, key). */
-    odataGetById<T>(entity: string, id: string): Promise<T>;
-    /** `$count=true&$top=0` — 데이터 없이 총 건수만. */
-    odataCount(entity: string, filter?: Record<string, unknown>): Promise<number>;
-    /** OData POST(생성) — 토스트 없이 결과만(일괄 처리에서 토스트 폭주 방지). */
-    odataPostQuiet<T>(entity: string, body: Partial<T>): Promise<T>;
-    /** OData POST(생성) — 성공 시 `saved` 토스트. */
-    odataPost<T>(entity: string, body: Partial<T>): Promise<T>;
-    /** OData PATCH(수정) — 토스트 없이 결과만(자식 컬렉션 편집 후 부모의 파생 필드를
-     *  함께 동기화하는 등, 한 사용자 액션이 여러 mutation을 낼 때 토스트 폭주 방지). */
-    odataPatchQuiet<T>(entity: string, id: string, body: Partial<T>): Promise<void>;
-    /** OData PATCH(수정) — 성공 시 `updated` 토스트. */
-    odataPatch<T>(entity: string, id: string, body: Partial<T>): Promise<void>;
-    /** OData DELETE — 토스트 없이(`odataPatchQuiet`와 같은 이유). */
-    odataDeleteQuiet(entity: string, id: string): Promise<void>;
-    /** OData DELETE — 성공 시 `deleted` 토스트. */
-    odataDelete(entity: string, id: string): Promise<void>;
-    /** custom REST GET — 204 등 빈 바디를 안전 파싱. */
-    apiGet<T>(path: string): Promise<T>;
-    /** custom REST POST. `body`가 `FormData` 인스턴스면 그대로(직렬화 없이) 멀티파트로
-     *  전송된다 — `@iyulab/http-client`가 Content-Type을 브라우저 자동 설정에 맡기고
-     *  JSON 직렬화 분기를 타지 않는다. `apiPut`/`apiPatch`도 동일하게 동작한다. */
-    apiPost<T>(path: string, body?: unknown): Promise<T>;
-    /** 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>;
-    /** URL 을 직접 조립한 커스텀 조회(csv-export 등)를 위해 raw 응답을 반환. */
-    fetchRaw(url: string): Promise<HttpResponse>;
-    /**
-     * flex-table `useODataSource` 에 주입할 공용 transport 옵션.
-     * useODataSource 는 자체 fetcher 를 쓰므로 별도로 `onUnauthorized` 를 배선해야 401 처리가 걸린다.
-     */
-    readonly sourceDefaults: {
-        baseUrl: string;
-        onUnauthorized: () => void;
-    };
-    /** `instanceof` 판정을 위해 재노출. (모듈 export `ApiError` 와 동일 클래스) */
-    readonly ApiError: typeof ApiError;
-}
-/**
- * OData v4 + custom REST 서비스를 생성한다.
- * 반환된 서비스는 상태를 공유하지 않는 순수 클로저이므로 여러 개를 만들어도 안전하다(테스트 격리에도 유리).
- */
-export declare function createODataService(config: ODataServiceConfig): ODataService;

package/dist/helpers/CurrencyHelper.d.ts

@@ -1,33 +0,0 @@
-/**
- * Currency formatting utility class.
- *
- * @deprecated The formatting logic now lives in `@iyulab/components`' `formatCurrency`
- * (framework-neutral, lower in the dependency stack so `@iyulab/modern-app` can consume it
- * too). This class is kept as a thin, behavior-preserving wrapper for existing callers —
- * new code should import `formatCurrency`/`formatNumber`/`formatDate` from
- * `@iyulab/components` directly.
- */
-export declare class CurrencyHelper {
-    /**
-     * Format amount as currency string.
-     * @param amount - Amount to format
-     * @param currency - Currency code (default: 'KRW')
-     * @param locale - Locale for formatting (default: 'ko-KR')
-     */
-    static formatCurrency(amount: number | null | undefined, currency?: string, locale?: string): string;
-    /** Format amount as Korean Won (KRW) */
-    static formatKRW(amount: number | null | undefined): string;
-    /** Format amount as US Dollar (USD) */
-    static formatUSD(amount: number | null | undefined): string;
-    /** Format amount as Euro (EUR) */
-    static formatEUR(amount: number | null | undefined): string;
-    /** Format amount as Japanese Yen (JPY) */
-    static formatJPY(amount: number | null | undefined): string;
-    /** Format amount as Chinese Yuan (CNY) */
-    static formatCNY(amount: number | null | undefined): string;
-    /**
-     * Parse currency string to number.
-     * @param value - Currency string to parse
-     */
-    static parseCurrency(value: string): number;
-}

package/dist/helpers/DateHelper.d.ts

@@ -1,61 +0,0 @@
-/**
- * Date manipulation and formatting utility class
- */
-export declare class DateHelper {
-    /**
-     * Format date to YYYY-MM-DD string
-     * @param date - Date to format (Date object or ISO string)
-     */
-    static formatDate(date: Date | string | null | undefined): string;
-    /**
-     * Format date to localized string
-     * @param date - Date to format
-     * @param locale - Locale for formatting (default: 'ko-KR')
-     * @param options - Intl.DateTimeFormat options
-     */
-    static formatLocalDate(date: Date | string | null | undefined, locale?: string, options?: Intl.DateTimeFormatOptions): string;
-    /**
-     * Format datetime to YYYY-MM-DD HH:mm string
-     * @param date - Date to format
-     */
-    static formatDateTime(date: Date | string | null | undefined): string;
-    /**
-     * Calculate days difference between two dates
-     * @param startDate - Start date
-     * @param endDate - End date
-     * @returns Number of days (positive if endDate > startDate)
-     */
-    static getDaysDifference(startDate: Date | string, endDate: Date | string): number;
-    /**
-     * Calculate days from now to target date
-     * @param targetDate - Target date
-     * @returns Days remaining (negative if overdue)
-     */
-    static getDaysFromNow(targetDate: Date | string): number;
-    /**
-     * Check if date is today
-     */
-    static isToday(date: Date | string): boolean;
-    /**
-     * Check if date is in the past
-     */
-    static isPast(date: Date | string): boolean;
-    /**
-     * Check if date is in the future
-     */
-    static isFuture(date: Date | string): boolean;
-    /**
-     * Add days to date
-     * @param date - Base date
-     * @param days - Number of days to add (can be negative)
-     */
-    static addDays(date: Date | string, days: number): Date;
-    /**
-     * Get start of day (00:00:00)
-     */
-    static startOfDay(date: Date | string): Date;
-    /**
-     * Get end of day (23:59:59.999)
-     */
-    static endOfDay(date: Date | string): Date;
-}