@connextable/popbill-juso 1.0.0

package/LICENSE.md

@@ -0,0 +1,19 @@
+Copyright (c) 2014 Linkhub
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/dist/index.d.mts

@@ -0,0 +1,386 @@
+import { LinkhubRequestClient } from "@connextable/popbill-runtime";
+
+//#region src/errors/index.d.ts
+/**
+ * 주소링크 요청 단계 상수입니다.
+ */
+declare const JusoLinkRequestStages: {
+  /**
+   * 토큰 발급 단계입니다.
+   */
+  readonly IssueToken: "issue_token";
+  /**
+   * API 요청 단계입니다.
+   */
+  readonly RequestApi: "request_api";
+};
+/**
+ * 주소링크 요청 단계 타입입니다.
+ */
+type JusoLinkRequestStage = (typeof JusoLinkRequestStages)[keyof typeof JusoLinkRequestStages];
+/**
+ * 주소링크 공통 예외 코드입니다.
+ */
+declare const JusoLinkErrorCodes: {
+  /**
+   * 원격 API 코드가 없는 경우 사용하는 내부 코드입니다.
+   */
+  readonly Unexpected: -99999999;
+};
+/**
+ * 주소링크 SDK 표준 에러 모델입니다.
+ */
+interface JusoApiErrorDetails {
+  /**
+   * 서비스가 반환한 에러 코드입니다.
+   */
+  code: number;
+  /**
+   * 에러 메시지입니다.
+   */
+  message: string;
+  /**
+   * HTTP 상태 코드입니다.
+   */
+  httpStatusCode?: number;
+  /**
+   * 실패한 공개 메서드 이름입니다.
+   */
+  operationName: string;
+  /**
+   * 실패 단계입니다.
+   */
+  requestStage: JusoLinkRequestStage;
+  /**
+   * 원본 예외 객체입니다.
+   */
+  cause?: unknown;
+}
+/**
+ * 주소링크 SDK 예외 클래스입니다.
+ */
+declare class JusoApiError extends Error implements JusoApiErrorDetails {
+  readonly code: number;
+  readonly httpStatusCode?: number;
+  readonly operationName: string;
+  readonly requestStage: JusoLinkRequestStage;
+  readonly cause?: unknown;
+  constructor(details: JusoApiErrorDetails);
+}
+/**
+ * 에러 정규화 입력 컨텍스트입니다.
+ */
+interface NormalizeJusoApiErrorContext {
+  /**
+   * 실패한 공개 메서드 이름입니다.
+   */
+  operationName: string;
+  /**
+   * 실패 단계입니다.
+   */
+  requestStage?: JusoLinkRequestStage;
+}
+/**
+ * 임의 예외를 `JusoApiError`로 정규화합니다.
+ */
+declare function normalizeJusoApiError(error: unknown, context: NormalizeJusoApiErrorContext): JusoApiError;
+/**
+ * 에러 핸들러를 안전하게 호출합니다.
+ */
+declare function dispatchJusoApiErrorSafely(handler: ((error: JusoApiError) => void) | undefined, error: JusoApiError): void;
+//#endregion
+//#region src/services/juso/types.d.ts
+/**
+ * 주소검색 시도 코드 상수입니다.
+ */
+declare const JusoLinkProvinceCodes: {
+  readonly Gangwon: "GANGWON";
+  readonly Gyeonggi: "GYEONGGI";
+  readonly Gyeongsangnam: "GYEONGSANGNAM";
+  readonly Gyeongsangbuk: "GYEONGSANGBUK";
+  readonly Gwangju: "GWANGJU";
+  readonly Daegu: "DAEGU";
+  readonly Daejeon: "DAEJEON";
+  readonly Busan: "BUSAN";
+  readonly Seoul: "SEOUL";
+  readonly Sejong: "SEJONG";
+  readonly Ulsan: "ULSAN";
+  readonly Incheon: "INCHEON";
+  readonly Jeollanam: "JEOLLANAM";
+  readonly Jeollabuk: "JEOLLABUK";
+  readonly Jeju: "JEJU";
+  readonly Chungcheongnam: "CHUNGCHEONGNAM";
+  readonly Chungcheongbuk: "CHUNGCHEONGBUK";
+};
+/**
+ * 주소검색 시도 코드 타입입니다.
+ */
+type JusoLinkProvinceCode = (typeof JusoLinkProvinceCodes)[keyof typeof JusoLinkProvinceCodes];
+/**
+ * 주소검색 입력 모델입니다.
+ */
+interface SearchAddressesInput {
+  /**
+   * 검색어입니다.
+   */
+  searchKeyword: string;
+  /**
+   * 페이지 번호입니다.
+   *
+   * @default 1
+   */
+  pageNumber?: number;
+  /**
+   * 페이지 크기입니다.
+   *
+   * 허용 범위는 1 이상 100 이하입니다.
+   * @default 20
+   */
+  pageSize?: number;
+  /**
+   * 차등검색 비활성화 여부입니다.
+   *
+   * `true` 이면 차등검색을 비활성화합니다.
+   * @default false
+   */
+  disableDifferentialSearch?: boolean;
+  /**
+   * 수정 제시어 비활성화 여부입니다.
+   *
+   * `true` 이면 수정 제시어를 비활성화합니다.
+   * @default false
+   */
+  disableSuggestion?: boolean;
+}
+/**
+ * 주소 항목 모델입니다.
+ */
+interface AddressSearchItem {
+  /**
+   * 도로명 기본주소입니다.
+   */
+  roadNameAddress: string;
+  /**
+   * 도로명 부가정보입니다.
+   */
+  roadNameAddressAdditionalInfo?: string;
+  /**
+   * 지번주소입니다.
+   */
+  lotNumberAddress: string;
+  /**
+   * 구우편번호입니다.
+   */
+  oldPostalCode: string;
+  /**
+   * 신우편번호(기초구역번호)입니다.
+   */
+  newPostalCode: string;
+  /**
+   * 상세건물명 목록입니다.
+   */
+  detailedBuildingNames: readonly string[];
+  /**
+   * 관련지번 목록입니다.
+   */
+  relatedLotNumbers: readonly string[];
+  /**
+   * 법정동 코드입니다.
+   */
+  legalDistrictCode: string;
+  /**
+   * 도로명 코드입니다.
+   */
+  roadNameCode: string;
+}
+/**
+ * 주소검색 결과 모델입니다.
+ */
+interface SearchAddressesResult {
+  /**
+   * 적용된 검색어입니다.
+   */
+  searchKeyword: string;
+  /**
+   * 차등검색에서 제외된 단어 목록입니다.
+   */
+  excludedKeywords: readonly string[];
+  /**
+   * 수정 제시어입니다.
+   */
+  suggestedKeyword?: string;
+  /**
+   * 시도별 검색 결과 수입니다.
+   */
+  provinceResultCountMap: Readonly<Partial<Record<JusoLinkProvinceCode, number>>>;
+  /**
+   * 총 검색 건수입니다.
+   */
+  totalResultCount: number;
+  /**
+   * 현재 페이지 주소 건수입니다.
+   */
+  pageResultCount: number;
+  /**
+   * 총 페이지 수입니다.
+   */
+  totalPageCount: number;
+  /**
+   * 현재 페이지 번호입니다.
+   */
+  pageNumber: number;
+  /**
+   * 현재 페이지 주소 목록입니다.
+   */
+  addresses: readonly AddressSearchItem[];
+}
+/**
+ * 주소링크 주소검색 서비스 인터페이스입니다.
+ */
+interface JusoService {
+  /**
+   * 주소를 검색합니다.
+   */
+  searchAddresses(input: SearchAddressesInput): Promise<SearchAddressesResult>;
+}
+//#endregion
+//#region src/services/juso/service.d.ts
+interface CreateJusoServiceInput {
+  /**
+   * 링크허브 공용 요청 클라이언트입니다.
+   */
+  requestClient: LinkhubRequestClient;
+  /**
+   * SDK 에러 콜백입니다.
+   */
+  onError?: (error: JusoApiError) => void;
+}
+/**
+ * 주소검색 서비스를 생성합니다.
+ */
+declare function createJusoService(input: CreateJusoServiceInput): JusoService;
+//#endregion
+//#region src/client/types.d.ts
+/**
+ * 주소링크 클라이언트 설정입니다.
+ */
+interface JusoLinkClientConfig {
+  /**
+   * 링크허브 링크아이디입니다.
+   */
+  linkId: string;
+  /**
+   * 링크허브 비밀키(base64)입니다.
+   */
+  secretKey: string;
+  /**
+   * 연동회원 식별자입니다.
+   */
+  accessId: string;
+  /**
+   * 주소링크 API 기본 URL 입니다.
+   *
+   * @default https://jusolink.linkhub.co.kr
+   */
+  apiBaseUrl?: string;
+  /**
+   * 링크허브 인증 API 기본 URL 입니다.
+   *
+   * @default https://auth.linkhub.co.kr
+   */
+  authBaseUrl?: string;
+  /**
+   * 토큰 사용 제한 아이피입니다.
+   */
+  forwardedIpAddress?: string;
+  /**
+   * 로컬 UTC 시간 사용 여부입니다.
+   *
+   * @default true
+   */
+  useLocalTime?: boolean;
+  /**
+   * 요청 제한시간(밀리초)입니다.
+   *
+   * @default 180000
+   */
+  requestTimeoutMilliseconds?: number;
+  /**
+   * Accept-Language 헤더 값입니다.
+   */
+  acceptLanguage?: string;
+  /**
+   * 에러 콜백입니다.
+   */
+  onError?: (error: JusoApiError) => void;
+}
+/**
+ * 주소링크 클라이언트입니다.
+ */
+interface JusoLinkClient {
+  /**
+   * 서비스 그룹입니다.
+   */
+  services: {
+    /**
+     * 주소검색 서비스입니다.
+     */
+    juso: JusoService;
+  };
+}
+//#endregion
+//#region src/client/index.d.ts
+/**
+ * 주소링크 클라이언트를 생성합니다.
+ */
+declare function createJusoLinkClient(configuration: JusoLinkClientConfig): JusoLinkClient;
+//#endregion
+//#region src/constants.d.ts
+/**
+ * 주소링크 기본 URL 상수입니다.
+ */
+declare const JusoLinkBaseUrls: {
+  /**
+   * 주소링크 API 기본 URL 입니다.
+   */
+  readonly Api: "https://jusolink.linkhub.co.kr";
+  /**
+   * 링크허브 인증 API 기본 URL 입니다.
+   */
+  readonly Auth: "https://auth.linkhub.co.kr";
+};
+/**
+ * 주소링크 검색 기본값 상수입니다.
+ */
+declare const JusoLinkSearchDefaults: {
+  /**
+   * 기본 페이지 번호입니다.
+   */
+  readonly PageNumber: 1;
+  /**
+   * 기본 페이지 크기입니다.
+   */
+  readonly PageSize: 20;
+  /**
+   * 허용되는 최대 페이지 크기입니다.
+   */
+  readonly MaximumPageSize: 100;
+  /**
+   * 기본 차등검색 사용 여부입니다.
+   */
+  readonly DisableDifferentialSearch: false;
+  /**
+   * 기본 수정 제시어 사용 여부입니다.
+   */
+  readonly DisableSuggestion: false;
+};
+/**
+ * 주소링크 SDK 기본 요청 제한시간(밀리초)입니다.
+ */
+declare const JusoLinkDefaultRequestTimeoutMilliseconds: 180000;
+/**
+ * 주소링크 SDK 기본 사용자 에이전트입니다.
+ */
+declare const JusoLinkUserAgent: "NODEJS JUSOLINK SDK";
+//#endregion
+export { type AddressSearchItem, JusoApiError, JusoApiErrorDetails, JusoLinkBaseUrls, type JusoLinkClient, type JusoLinkClientConfig, JusoLinkDefaultRequestTimeoutMilliseconds, JusoLinkErrorCodes, type JusoLinkProvinceCode, JusoLinkProvinceCodes, JusoLinkRequestStage, JusoLinkRequestStages, JusoLinkSearchDefaults, JusoLinkUserAgent, type JusoService, NormalizeJusoApiErrorContext, type SearchAddressesInput, type SearchAddressesResult, createJusoLinkClient, createJusoService, dispatchJusoApiErrorSafely, normalizeJusoApiError };

package/dist/index.mjs

@@ -0,0 +1,311 @@
+import { LinkhubAuthScope, LinkhubServiceIds, createLinkhubAuthClient, createLinkhubRequestClient, createTokenProvider } from "@connextable/popbill-runtime";
+import { normalizeErrorMessage, normalizeOptionalString, normalizeRequiredString, trimTrailingSlash } from "@connextable/popbill-utils";
+//#region src/constants.ts
+/**
+* 주소링크 기본 URL 상수입니다.
+*/
+const JusoLinkBaseUrls = {
+	/**
+	* 주소링크 API 기본 URL 입니다.
+	*/
+	Api: "https://jusolink.linkhub.co.kr",
+	/**
+	* 링크허브 인증 API 기본 URL 입니다.
+	*/
+	Auth: "https://auth.linkhub.co.kr"
+};
+/**
+* 주소링크 검색 기본값 상수입니다.
+*/
+const JusoLinkSearchDefaults = {
+	/**
+	* 기본 페이지 번호입니다.
+	*/
+	PageNumber: 1,
+	/**
+	* 기본 페이지 크기입니다.
+	*/
+	PageSize: 20,
+	/**
+	* 허용되는 최대 페이지 크기입니다.
+	*/
+	MaximumPageSize: 100,
+	/**
+	* 기본 차등검색 사용 여부입니다.
+	*/
+	DisableDifferentialSearch: false,
+	/**
+	* 기본 수정 제시어 사용 여부입니다.
+	*/
+	DisableSuggestion: false
+};
+/**
+* 주소링크 SDK 기본 요청 제한시간(밀리초)입니다.
+*/
+const JusoLinkDefaultRequestTimeoutMilliseconds = 18e4;
+/**
+* 주소링크 SDK 기본 사용자 에이전트입니다.
+*/
+const JusoLinkUserAgent = "NODEJS JUSOLINK SDK";
+//#endregion
+//#region src/services/juso/types.ts
+/**
+* 주소검색 시도 코드 상수입니다.
+*/
+const JusoLinkProvinceCodes = {
+	Gangwon: "GANGWON",
+	Gyeonggi: "GYEONGGI",
+	Gyeongsangnam: "GYEONGSANGNAM",
+	Gyeongsangbuk: "GYEONGSANGBUK",
+	Gwangju: "GWANGJU",
+	Daegu: "DAEGU",
+	Daejeon: "DAEJEON",
+	Busan: "BUSAN",
+	Seoul: "SEOUL",
+	Sejong: "SEJONG",
+	Ulsan: "ULSAN",
+	Incheon: "INCHEON",
+	Jeollanam: "JEOLLANAM",
+	Jeollabuk: "JEOLLABUK",
+	Jeju: "JEJU",
+	Chungcheongnam: "CHUNGCHEONGNAM",
+	Chungcheongbuk: "CHUNGCHEONGBUK"
+};
+//#endregion
+//#region src/errors/index.ts
+/**
+* 주소링크 요청 단계 상수입니다.
+*/
+const JusoLinkRequestStages = {
+	/**
+	* 토큰 발급 단계입니다.
+	*/
+	IssueToken: "issue_token",
+	/**
+	* API 요청 단계입니다.
+	*/
+	RequestApi: "request_api"
+};
+/**
+* 주소링크 공통 예외 코드입니다.
+*/
+const JusoLinkErrorCodes = { 
+/**
+* 원격 API 코드가 없는 경우 사용하는 내부 코드입니다.
+*/
+Unexpected: -99999999 };
+/**
+* 주소링크 SDK 예외 클래스입니다.
+*/
+var JusoApiError = class extends Error {
+	code;
+	httpStatusCode;
+	operationName;
+	requestStage;
+	cause;
+	constructor(details) {
+		super(details.message);
+		this.name = "JusoApiError";
+		this.code = details.code;
+		this.httpStatusCode = details.httpStatusCode;
+		this.operationName = details.operationName;
+		this.requestStage = details.requestStage;
+		this.cause = details.cause;
+	}
+};
+/**
+* 임의 예외를 `JusoApiError`로 정규화합니다.
+*/
+function normalizeJusoApiError(error, context) {
+	if (error instanceof JusoApiError) return error;
+	if (isJusoLinkRequestStageError(error)) return normalizeJusoApiError(error.cause, {
+		operationName: context.operationName,
+		requestStage: error.requestStage
+	});
+	if (isHttpResponseErrorShape(error)) {
+		const remoteError = extractRemoteError(error.body);
+		return new JusoApiError({
+			code: remoteError?.code ?? JusoLinkErrorCodes.Unexpected,
+			message: remoteError?.message ?? createFallbackMessage(error.body),
+			httpStatusCode: error.status,
+			operationName: context.operationName,
+			requestStage: context.requestStage ?? JusoLinkRequestStages.RequestApi,
+			cause: error
+		});
+	}
+	return new JusoApiError({
+		code: JusoLinkErrorCodes.Unexpected,
+		message: normalizeErrorMessage(error),
+		operationName: context.operationName,
+		requestStage: context.requestStage ?? JusoLinkRequestStages.RequestApi,
+		cause: error
+	});
+}
+/**
+* 에러 핸들러를 안전하게 호출합니다.
+*/
+function dispatchJusoApiErrorSafely(handler, error) {
+	if (!handler) return;
+	try {
+		handler(error);
+	} catch {}
+}
+function extractRemoteError(value) {
+	if (typeof value !== "object" || value === null) return;
+	const candidate = value;
+	if (typeof candidate.code !== "number" || typeof candidate.message !== "string") return;
+	return {
+		code: candidate.code,
+		message: candidate.message
+	};
+}
+function createFallbackMessage(value) {
+	if (typeof value === "string") return value;
+	return normalizeErrorMessage(value);
+}
+function isJusoLinkRequestStageError(error) {
+	if (typeof error !== "object" || error === null) return false;
+	if (!("requestStage" in error) || !("cause" in error)) return false;
+	const requestStage = error.requestStage;
+	return requestStage === JusoLinkRequestStages.IssueToken || requestStage === JusoLinkRequestStages.RequestApi;
+}
+function isHttpResponseErrorShape(error) {
+	if (typeof error !== "object" || error === null) return false;
+	if (!("status" in error) || !("body" in error)) return false;
+	return typeof error.status === "number";
+}
+//#endregion
+//#region src/services/juso/service.ts
+const SEARCH_ADDRESSES_OPERATION = "juso.searchAddresses";
+/**
+* 주소검색 서비스를 생성합니다.
+*/
+function createJusoService(input) {
+	return { async searchAddresses(searchInput) {
+		try {
+			const normalizedSearchInput = normalizeSearchInput(searchInput);
+			const queryParameters = new URLSearchParams({
+				Searches: normalizedSearchInput.searchKeyword,
+				PageNum: String(normalizedSearchInput.pageNumber),
+				PerPage: String(normalizedSearchInput.pageSize),
+				noDifferential: String(normalizedSearchInput.disableDifferentialSearch),
+				noSuggest: String(normalizedSearchInput.disableSuggestion)
+			});
+			return mapSearchResult(await input.requestClient.requestJson({
+				uri: `/Search?${queryParameters.toString()}`,
+				method: "GET"
+			}));
+		} catch (error) {
+			const normalizedError = normalizeJusoApiError(error, { operationName: SEARCH_ADDRESSES_OPERATION });
+			dispatchJusoApiErrorSafely(input.onError, normalizedError);
+			throw normalizedError;
+		}
+	} };
+}
+function normalizeSearchInput(input) {
+	return {
+		searchKeyword: normalizeRequiredString(input.searchKeyword, "searchKeyword는 필수입니다."),
+		pageNumber: normalizePositiveInteger(input.pageNumber, JusoLinkSearchDefaults.PageNumber, "pageNumber"),
+		pageSize: normalizePageSize(input.pageSize),
+		disableDifferentialSearch: input.disableDifferentialSearch ?? JusoLinkSearchDefaults.DisableDifferentialSearch,
+		disableSuggestion: input.disableSuggestion ?? JusoLinkSearchDefaults.DisableSuggestion
+	};
+}
+function normalizePositiveInteger(value, defaultValue, fieldName) {
+	if (value === void 0) return defaultValue;
+	if (!Number.isInteger(value) || value < 1) throw new Error(`${fieldName}는 1 이상의 정수여야 합니다.`);
+	return value;
+}
+function normalizePageSize(value) {
+	const pageSize = normalizePositiveInteger(value, JusoLinkSearchDefaults.PageSize, "pageSize");
+	if (pageSize > JusoLinkSearchDefaults.MaximumPageSize) throw new Error(`pageSize는 ${String(JusoLinkSearchDefaults.MaximumPageSize)} 이하여야 합니다.`);
+	return pageSize;
+}
+function mapSearchResult(apiResponse) {
+	return {
+		searchKeyword: apiResponse.searches,
+		excludedKeywords: apiResponse.deletedWord ?? [],
+		suggestedKeyword: normalizeOptionalString(apiResponse.suggest),
+		provinceResultCountMap: mapProvinceResultCountMap(apiResponse.sidoCount),
+		totalResultCount: apiResponse.numFound,
+		pageResultCount: apiResponse.listSize,
+		totalPageCount: apiResponse.totalPage,
+		pageNumber: apiResponse.page,
+		addresses: (apiResponse.juso ?? []).map(mapAddressItem)
+	};
+}
+function mapAddressItem(item) {
+	return {
+		roadNameAddress: item.roadAddr1,
+		roadNameAddressAdditionalInfo: normalizeOptionalString(item.roadAddr2),
+		lotNumberAddress: item.jibunAddr,
+		oldPostalCode: item.zipcode,
+		newPostalCode: item.sectionNum,
+		detailedBuildingNames: item.detailBuildingName ?? [],
+		relatedLotNumbers: item.relatedJibun ?? [],
+		legalDistrictCode: item.dongCode,
+		roadNameCode: item.streetCode
+	};
+}
+function mapProvinceResultCountMap(source) {
+	if (!source) return {};
+	const result = {};
+	const validProvinceCodeSet = new Set(Object.values(JusoLinkProvinceCodes));
+	for (const [provinceCode, count] of Object.entries(source)) {
+		if (!validProvinceCodeSet.has(provinceCode)) continue;
+		result[provinceCode] = count;
+	}
+	return result;
+}
+//#endregion
+//#region src/client/index.ts
+/**
+* 주소링크 클라이언트를 생성합니다.
+*/
+function createJusoLinkClient(configuration) {
+	const resolvedConfiguration = resolveConfiguration(configuration);
+	const tokenProvider = createTokenProvider({
+		authClient: createLinkhubAuthClient({
+			linkId: resolvedConfiguration.linkId,
+			secretKey: resolvedConfiguration.secretKey,
+			authBaseUrl: resolvedConfiguration.authBaseUrl,
+			useLocalTime: resolvedConfiguration.useLocalTime,
+			timeoutMs: resolvedConfiguration.requestTimeoutMilliseconds
+		}),
+		serviceId: LinkhubServiceIds.JusoLink,
+		scopes: [LinkhubAuthScope.Member],
+		forwardedIp: resolvedConfiguration.forwardedIpAddress
+	});
+	return { services: { juso: createJusoService({
+		requestClient: createLinkhubRequestClient({
+			apiBaseUrl: resolvedConfiguration.apiBaseUrl,
+			timeoutMs: resolvedConfiguration.requestTimeoutMilliseconds,
+			tokenProvider,
+			tokenCacheKey: resolvedConfiguration.accessId,
+			acceptLanguage: resolvedConfiguration.acceptLanguage,
+			userAgent: JusoLinkUserAgent
+		}),
+		onError: resolvedConfiguration.onError
+	}) } };
+}
+function resolveConfiguration(configuration) {
+	return {
+		linkId: normalizeRequiredString(configuration.linkId, "linkId는 필수입니다."),
+		secretKey: normalizeRequiredString(configuration.secretKey, "secretKey는 필수입니다."),
+		accessId: normalizeRequiredString(configuration.accessId, "accessId는 필수입니다."),
+		apiBaseUrl: trimTrailingSlash(configuration.apiBaseUrl ?? JusoLinkBaseUrls.Api),
+		authBaseUrl: trimTrailingSlash(configuration.authBaseUrl ?? JusoLinkBaseUrls.Auth),
+		forwardedIpAddress: normalizeOptionalString(configuration.forwardedIpAddress),
+		useLocalTime: configuration.useLocalTime ?? true,
+		requestTimeoutMilliseconds: normalizeRequestTimeoutMilliseconds(configuration.requestTimeoutMilliseconds),
+		acceptLanguage: normalizeOptionalString(configuration.acceptLanguage),
+		onError: configuration.onError
+	};
+}
+function normalizeRequestTimeoutMilliseconds(value) {
+	if (value === void 0) return JusoLinkDefaultRequestTimeoutMilliseconds;
+	if (!Number.isInteger(value) || value <= 0) throw new Error("requestTimeoutMilliseconds는 1 이상의 정수여야 합니다.");
+	return value;
+}
+//#endregion
+export { JusoApiError, JusoLinkBaseUrls, JusoLinkDefaultRequestTimeoutMilliseconds, JusoLinkErrorCodes, JusoLinkProvinceCodes, JusoLinkRequestStages, JusoLinkSearchDefaults, JusoLinkUserAgent, createJusoLinkClient, createJusoService, dispatchJusoApiErrorSafely, normalizeJusoApiError };

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@connextable/popbill-juso",
+  "version": "1.0.0",
+  "description": "JusoLink API SDK for TypeScript",
+  "bugs": {
+    "url": "https://github.com/connextable/popbill/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/connextable/popbill.git"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@connextable/popbill-runtime": "1.0.0",
+    "@connextable/popbill-utils": "1.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "lint": "oxlint --type-aware",
+    "lint:fix": "oxlint --fix",
+    "fmt": "oxfmt",
+    "fmt:check": "oxfmt --check",
+    "typecheck": "tsgo -b --noEmit",
+    "typecheck:lib": "tsgo -p tsconfig.lib.json --noEmit",
+    "typecheck:test": "tsgo -p tsconfig.test.json --noEmit",
+    "clean": "del node_modules dist"
+  }
+}