@safeticsinc/dra 0.0.1

package/dist/cli/core/error.js

@@ -0,0 +1,252 @@
+/**
+ * DRA (Danger Risk Assessment) 에러 처리 시스템
+ * 안전거리 계산 중 발생하는 다양한 에러를 구분하여 처리
+ */
+/**
+ * DRA 기본 에러 클래스
+ * 모든 DRA 특화 에러는 이 클래스를 상속받음
+ */
+export class DRAError extends Error {
+    constructor(message, code = 'DRA_ERROR', context) {
+        super(message);
+        this.name = 'DRAError';
+        this.code = code;
+        this.context = context;
+        this.timestamp = new Date();
+        // 프로토타입 체인 설정 (TypeScript에서 클래스 상속 시 필요)
+        Object.setPrototypeOf(this, DRAError.prototype);
+    }
+    /**
+     * 에러 정보를 객체로 반환
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            context: this.context,
+            timestamp: this.timestamp,
+        };
+    }
+    /**
+     * 에러 정보를 문자열로 반환
+     */
+    toString() {
+        const contextStr = this.context
+            ? `\n컨텍스트: ${JSON.stringify(this.context, null, 2)}`
+            : '';
+        return `[${this.code}] ${this.message}${contextStr}`;
+    }
+}
+export default DRAError;
+/**
+ * 입력 파라미터 검증 에러
+ * 필수 파라미터가 누락되었거나 잘못된 형식일 때 발생
+ */
+export class ValidationError extends DRAError {
+    constructor(message, context) {
+        super(message, 'VALIDATION_ERROR', context);
+        this.name = 'ValidationError';
+        Object.setPrototypeOf(this, ValidationError.prototype);
+    }
+}
+/**
+ * 파라미터 범위 벗어남 에러
+ * 입력값이 허용된 범위를 벗어났을 때 발생
+ */
+export class OutOfRangeError extends DRAError {
+    constructor(paramName, value, minValue, maxValue) {
+        const message = minValue !== undefined && maxValue !== undefined
+            ? `파라미터 '${paramName}'은(는) ${minValue}~${maxValue} 범위여야 합니다. (현재값: ${value})`
+            : minValue !== undefined
+                ? `파라미터 '${paramName}'은(는) ${minValue} 이상이어야 합니다. (현재값: ${value})`
+                : `파라미터 '${paramName}'은(는) ${maxValue} 이하여야 합니다. (현재값: ${value})`;
+        super(message, 'OUT_OF_RANGE_ERROR', {
+            paramName,
+            value,
+            minValue,
+            maxValue,
+        });
+        this.name = 'OutOfRangeError';
+        this.paramName = paramName;
+        this.value = value;
+        this.minValue = minValue;
+        this.maxValue = maxValue;
+        Object.setPrototypeOf(this, OutOfRangeError.prototype);
+    }
+}
+/**
+ * 필수 파라미터 누락 에러
+ * 필수 파라미터가 제공되지 않았을 때 발생
+ */
+export class MissingParameterError extends DRAError {
+    constructor(requiredParams) {
+        const paramList = requiredParams.join(', ');
+        const message = `필수 파라미터가 누락되었습니다: ${paramList}`;
+        super(message, 'MISSING_PARAMETER_ERROR', { requiredParams });
+        this.name = 'MissingParameterError';
+        this.requiredParams = requiredParams;
+        Object.setPrototypeOf(this, MissingParameterError.prototype);
+    }
+}
+/**
+ * 계산 에러
+ * 계산 과정에서 수학적 오류 또는 불가능한 연산이 발생했을 때
+ */
+export class CalculationError extends DRAError {
+    constructor(message, formulaCode, params) {
+        super(message, 'CALCULATION_ERROR', { formulaCode, params });
+        this.name = 'CalculationError';
+        this.formulaCode = formulaCode;
+        this.params = params;
+        Object.setPrototypeOf(this, CalculationError.prototype);
+    }
+}
+/**
+ * 불가능한 상태 에러
+ * 현재 상태에서 요청된 작업을 수행할 수 없을 때 발생
+ */
+export class InvalidStateError extends DRAError {
+    constructor(message, currentState, requiredState) {
+        super(message, 'INVALID_STATE_ERROR', {
+            currentState,
+            requiredState,
+        });
+        this.name = 'InvalidStateError';
+        this.currentState = currentState;
+        this.requiredState = requiredState || '';
+        Object.setPrototypeOf(this, InvalidStateError.prototype);
+    }
+}
+/**
+ * 타입 에러
+ * 예상과 다른 타입의 값이 제공되었을 때 발생
+ */
+export class TypeError extends DRAError {
+    constructor(paramName, expectedType, actualType) {
+        const message = `파라미터 '${paramName}'의 타입이 잘못되었습니다. (예상: ${expectedType}, 실제: ${actualType})`;
+        super(message, 'TYPE_ERROR', {
+            paramName,
+            expectedType,
+            actualType,
+        });
+        this.name = 'TypeError';
+        this.paramName = paramName;
+        this.expectedType = expectedType;
+        this.actualType = actualType;
+        Object.setPrototypeOf(this, TypeError.prototype);
+    }
+}
+/**
+ * 안전 기준 미만 에러
+ * 계산된 안전거리가 최소 안전거리 기준을 만족하지 못할 때 발생
+ */
+export class SafetyThresholdError extends DRAError {
+    constructor(calculatedValue, minimumRequired) {
+        const safetyMargin = minimumRequired - calculatedValue;
+        const message = `안전거리가 기준을 충족하지 못했습니다. (계산값: ${calculatedValue}mm, 필요값: ${minimumRequired}mm, 부족: ${safetyMargin}mm)`;
+        super(message, 'SAFETY_THRESHOLD_ERROR', {
+            calculatedValue,
+            minimumRequired,
+            safetyMargin,
+        });
+        this.name = 'SafetyThresholdError';
+        this.calculatedValue = calculatedValue;
+        this.minimumRequired = minimumRequired;
+        this.safetyMargin = safetyMargin;
+        Object.setPrototypeOf(this, SafetyThresholdError.prototype);
+    }
+}
+/**
+ * 에러 검증 및 처리 유틸리티
+ */
+export class ErrorHandler {
+    /**
+     * 값이 범위 내에 있는지 검증
+     */
+    static validateRange(paramName, value, minValue, maxValue) {
+        if (minValue !== undefined &&
+            maxValue !== undefined &&
+            (value < minValue || value > maxValue)) {
+            throw new OutOfRangeError(paramName, value, minValue, maxValue);
+        }
+        if (minValue !== undefined && value < minValue) {
+            throw new OutOfRangeError(paramName, value, minValue, undefined);
+        }
+        if (maxValue !== undefined && value > maxValue) {
+            throw new OutOfRangeError(paramName, value, undefined, maxValue);
+        }
+    }
+    /**
+     * 필수 파라미터 검증
+     */
+    static validateRequired(params, requiredKeys) {
+        const missingKeys = requiredKeys.filter((key) => !(key in params));
+        if (missingKeys.length > 0) {
+            throw new MissingParameterError(missingKeys);
+        }
+    }
+    /**
+     * 타입 검증
+     */
+    static validateType(paramName, value, expectedType) {
+        const actualType = typeof value;
+        if (actualType !== expectedType) {
+            throw new TypeError(paramName, expectedType, actualType);
+        }
+    }
+    /**
+     * 값이 0이 아닌지 검증 (나눗셈 방지)
+     */
+    static validateNonZero(paramName, value) {
+        if (value === 0) {
+            throw new ValidationError(`파라미터 '${paramName}'은(는) 0이 될 수 없습니다.`, { paramName, value });
+        }
+    }
+    /**
+     * 배열이 최소 길이 이상인지 검증
+     */
+    static validateArrayLength(paramName, array, minLength) {
+        if (array.length < minLength) {
+            throw new ValidationError(`파라미터 '${paramName}'은(는) 최소 ${minLength}개 이상의 요소를 가져야 합니다. (현재: ${array.length}개)`, { paramName, minLength, actualLength: array.length });
+        }
+    }
+    /**
+     * 안전거리 기준 검증
+     */
+    static validateSafetyThreshold(calculatedValue, minimumRequired) {
+        if (calculatedValue < minimumRequired) {
+            throw new SafetyThresholdError(calculatedValue, minimumRequired);
+        }
+    }
+    /**
+     * 에러를 캐치하고 로깅
+     */
+    static catch(error, fallbackMessage = '알 수 없는 에러가 발생했습니다') {
+        if (error instanceof DRAError) {
+            console.error(`[${error.code}] ${error.message}`);
+            return error;
+        }
+        if (error instanceof Error) {
+            console.error(`[ERROR] ${error.message}`);
+            return new DRAError(error.message);
+        }
+        console.error(`[ERROR] ${fallbackMessage}`);
+        return new DRAError(fallbackMessage);
+    }
+    /**
+     * 에러 정보를 상세히 출력
+     */
+    static log(error) {
+        console.error(`
+═══════════════════════════════════════════════════════════
+  [${error.code}] ${error.name}
+═══════════════════════════════════════════════════════════
+  메시지: ${error.message}
+  시간: ${error.timestamp.toISOString()}
+${error.context ? `  상세정보:\n${JSON.stringify(error.context, null, 4)}` : ''}
+═══════════════════════════════════════════════════════════
+    `);
+    }
+}
+//# sourceMappingURL=error.js.map

package/dist/cli/core/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../../src/core/error.ts"],"names":[],"mappings":"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"}

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,133 @@
+import * as readline from 'readline';
+import { ISO13855 } from '../algorithm/formulas';
+import { DRAError } from '../core/error';
+class InteractiveCLI {
+    constructor() {
+        this.rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+    }
+    start() {
+        this.showWelcome();
+        this.showMenu();
+    }
+    showWelcome() {
+        console.log(`
+╔═══════════════════════════════════════════════════════════╗
+║    🛡️  DRA 안전거리 계산기 (대화형)                     ║
+╚═══════════════════════════════════════════════════════════╝
+    `);
+    }
+    showMenu() {
+        const menu = `
+📋 선택할 계산 유형:
+  1. A1 - 반응 시간 계산
+  2. A17 - 열림 거리/속도 계산
+  3. B1 - 통계 분석
+  4. B6 - 최대값 선택
+  5. 종료
+
+    `;
+        console.log(menu);
+        this.prompt('선택 (1-5): ', this.handleMenuChoice.bind(this));
+    }
+    handleMenuChoice(choice) {
+        switch (choice.trim()) {
+            case '1':
+                this.inputA1();
+                break;
+            case '2':
+                this.inputA17();
+                break;
+            case '3':
+                this.inputB1();
+                break;
+            case '4':
+                this.inputB6();
+                break;
+            case '5':
+                this.exit();
+                break;
+            default:
+                console.error('❌ 잘못된 선택');
+                this.showMenu();
+        }
+    }
+    inputA1() {
+        this.prompt('K 값: ', (K) => {
+            this.prompt('T 값: ', (T) => {
+                this.prompt('C 값: ', (C) => {
+                    try {
+                        const result = ISO13855.A1(parseFloat(K), parseFloat(T), parseFloat(C));
+                        console.log(`\n✅ 결과: ${result}\n`);
+                    }
+                    catch (error) {
+                        this.handleError(error);
+                    }
+                    this.showMenu();
+                });
+            });
+        });
+    }
+    inputA17() {
+        this.prompt('e 값: ', (e) => {
+            this.prompt('v 값: ', (v) => {
+                try {
+                    const result = ISO13855.A17(parseFloat(e), parseFloat(v));
+                    console.log(`\n✅ 결과: ${result}\n`);
+                }
+                catch (error) {
+                    this.handleError(error);
+                }
+                this.showMenu();
+            });
+        });
+    }
+    inputB1() {
+        this.prompt('측정값을 쉼표로 분리해서 입력 (최소 10개): ', (input) => {
+            try {
+                const measurements = input.split(',').map((v) => parseFloat(v.trim()));
+                const result = ISO13855.B1(measurements);
+                console.log(`\n✅ 결과: ${result}\n`);
+            }
+            catch (error) {
+                this.handleError(error);
+            }
+            this.showMenu();
+        });
+    }
+    inputB6() {
+        this.prompt('S_RT 값: ', (S_RT) => {
+            this.prompt('S_RO 값: ', (S_RO) => {
+                try {
+                    const result = ISO13855.B6(parseFloat(S_RT), parseFloat(S_RO));
+                    console.log(`\n✅ 결과: ${result}\n`);
+                }
+                catch (error) {
+                    this.handleError(error);
+                }
+                this.showMenu();
+            });
+        });
+    }
+    handleError(error) {
+        if (error instanceof DRAError) {
+            console.error(`\n❌ [${error.code}] ${error.message}`);
+        }
+        else if (error instanceof Error) {
+            console.error(`\n❌ 에러: ${error.message}`);
+        }
+    }
+    prompt(question, callback) {
+        this.rl.question(question, callback);
+    }
+    exit() {
+        console.log('\n👋 프로그램을 종료합니다.');
+        this.rl.close();
+    }
+}
+// 실행
+const cli = new InteractiveCLI();
+cli.start();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/core/error.d.ts

@@ -0,0 +1,131 @@
+/**
+ * DRA (Danger Risk Assessment) 에러 처리 시스템
+ * 안전거리 계산 중 발생하는 다양한 에러를 구분하여 처리
+ */
+/**
+ * DRA 기본 에러 클래스
+ * 모든 DRA 특화 에러는 이 클래스를 상속받음
+ */
+export declare class DRAError extends Error {
+    readonly code: string;
+    readonly context?: Record<string, any>;
+    readonly timestamp: Date;
+    constructor(message: string, code?: string, context?: Record<string, any>);
+    /**
+     * 에러 정보를 객체로 반환
+     */
+    toJSON(): {
+        name: string;
+        code: string;
+        message: string;
+        context: Record<string, any> | undefined;
+        timestamp: Date;
+    };
+    /**
+     * 에러 정보를 문자열로 반환
+     */
+    toString(): string;
+}
+export default DRAError;
+/**
+ * 입력 파라미터 검증 에러
+ * 필수 파라미터가 누락되었거나 잘못된 형식일 때 발생
+ */
+export declare class ValidationError extends DRAError {
+    constructor(message: string, context?: Record<string, any>);
+}
+/**
+ * 파라미터 범위 벗어남 에러
+ * 입력값이 허용된 범위를 벗어났을 때 발생
+ */
+export declare class OutOfRangeError extends DRAError {
+    readonly paramName: string;
+    readonly value: number;
+    readonly minValue?: number;
+    readonly maxValue?: number;
+    constructor(paramName: string, value: number, minValue?: number, maxValue?: number);
+}
+/**
+ * 필수 파라미터 누락 에러
+ * 필수 파라미터가 제공되지 않았을 때 발생
+ */
+export declare class MissingParameterError extends DRAError {
+    readonly requiredParams: string[];
+    constructor(requiredParams: string[]);
+}
+/**
+ * 계산 에러
+ * 계산 과정에서 수학적 오류 또는 불가능한 연산이 발생했을 때
+ */
+export declare class CalculationError extends DRAError {
+    readonly formulaCode: string;
+    readonly params: Record<string, any>;
+    constructor(message: string, formulaCode: string, params: Record<string, any>);
+}
+/**
+ * 불가능한 상태 에러
+ * 현재 상태에서 요청된 작업을 수행할 수 없을 때 발생
+ */
+export declare class InvalidStateError extends DRAError {
+    readonly currentState: string;
+    readonly requiredState: string;
+    constructor(message: string, currentState: string, requiredState?: string);
+}
+/**
+ * 타입 에러
+ * 예상과 다른 타입의 값이 제공되었을 때 발생
+ */
+export declare class TypeError extends DRAError {
+    readonly paramName: string;
+    readonly expectedType: string;
+    readonly actualType: string;
+    constructor(paramName: string, expectedType: string, actualType: string);
+}
+/**
+ * 안전 기준 미만 에러
+ * 계산된 안전거리가 최소 안전거리 기준을 만족하지 못할 때 발생
+ */
+export declare class SafetyThresholdError extends DRAError {
+    readonly calculatedValue: number;
+    readonly minimumRequired: number;
+    readonly safetyMargin: number;
+    constructor(calculatedValue: number, minimumRequired: number);
+}
+/**
+ * 에러 검증 및 처리 유틸리티
+ */
+export declare class ErrorHandler {
+    /**
+     * 값이 범위 내에 있는지 검증
+     */
+    static validateRange(paramName: string, value: number, minValue?: number, maxValue?: number): void;
+    /**
+     * 필수 파라미터 검증
+     */
+    static validateRequired(params: Record<string, any>, requiredKeys: string[]): void;
+    /**
+     * 타입 검증
+     */
+    static validateType(paramName: string, value: any, expectedType: string): void;
+    /**
+     * 값이 0이 아닌지 검증 (나눗셈 방지)
+     */
+    static validateNonZero(paramName: string, value: number): void;
+    /**
+     * 배열이 최소 길이 이상인지 검증
+     */
+    static validateArrayLength(paramName: string, array: any[], minLength: number): void;
+    /**
+     * 안전거리 기준 검증
+     */
+    static validateSafetyThreshold(calculatedValue: number, minimumRequired: number): void;
+    /**
+     * 에러를 캐치하고 로깅
+     */
+    static catch(error: unknown, fallbackMessage?: string): DRAError;
+    /**
+     * 에러 정보를 상세히 출력
+     */
+    static log(error: DRAError): void;
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/core/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/core/error.ts"],"names":[],"mappings":"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"}