@cp949/japanpost-react 1.0.2 → 1.0.3

package/README.ko.md

@@ -18,6 +18,28 @@ pnpm add @cp949/japanpost-react
 
 - 지원 React 버전: React 18, React 19
 
+이 패키지는 ESM으로 배포됩니다. 서버 유틸리티와 공용 타입은
+`@cp949/japanpost-react`에서 가져오고, Next.js App Router에서 훅이나
+headless 입력 컴포넌트는 `@cp949/japanpost-react/client`를 사용하세요.
+`require("@cp949/japanpost-react")`,
+`require("@cp949/japanpost-react/client")`는 지원되지 않으며, CommonJS
+소비자는 `const pkg = await import("@cp949/japanpost-react");` 같은 ESM
+interop을 사용해야 합니다.
+
+## Next.js
+
+Next.js App Router에서 훅이나 headless 입력 컴포넌트를 쓸 때는
+클라이언트 컴포넌트 안에서 `@cp949/japanpost-react/client` 경로를
+사용하는 것을 권장합니다. 유틸리티 함수와 공용 타입은 루트 엔트리에서
+가져오면 됩니다.
+
+```tsx
+"use client";
+
+import { PostalCodeInput, useJapanPostalCode } from "@cp949/japanpost-react/client";
+import { normalizeJapanPostalCode, type JapanAddressDataSource } from "@cp949/japanpost-react";
+```
+
 ## 빠른 시작
 
 ```tsx
@@ -157,6 +179,9 @@ export function PostalForm() {
 성공할 수 있고, `404 -> not_found`는 miss를 오류로 노출하는 백엔드에서만
 선택적으로 쓰면 됩니다.
 
+Next.js에서도 `dataSource`는 자체 서버 API를 바라보도록 두고, Japan Post
+업스트림 자격 증명과 토큰 교환은 브라우저가 아니라 서버에서 처리하세요.
+
 ## Exports
 
 - `normalizeJapanPostalCode`
@@ -345,5 +370,6 @@ timeout 메시지는 토큰 발급 단계와 실제 조회 단계 중 어느 쪽
 ## SSR
 
 `dataSource` 구현에서는 서버 측 API를 사용하고, 토큰 교환과 업스트림 서명은
-서버에서만 처리하세요. React 훅과 UI 컴포넌트는 클라이언트 컴포넌트에서
+서버에서만 처리하세요. Next.js App Router에서는 React 훅과 UI 컴포넌트를
+`@cp949/japanpost-react/client`에서 import해 클라이언트 컴포넌트에서
 사용하는 것이 안전합니다.

package/README.md

@@ -21,6 +21,26 @@ pnpm add @cp949/japanpost-react
   `packages/japanpost-react`
 - Demo app in this repository: `apps/demo`
 
+This package is published as ESM. Keep server utilities and shared types on
+`@cp949/japanpost-react`, and import hooks or headless input components for the
+Next.js App Router from `@cp949/japanpost-react/client`. CommonJS consumers
+must use ESM interop. `require("@cp949/japanpost-react")` and
+`require("@cp949/japanpost-react/client")` are not supported. In CommonJS, use
+ESM interop such as `const pkg = await import("@cp949/japanpost-react");`.
+
+## Next.js
+
+When you use hooks or headless input components in the Next.js App Router,
+import them from `@cp949/japanpost-react/client` inside a Client Component.
+Keep utility functions and shared types on the root entry.
+
+```tsx
+"use client";
+
+import { PostalCodeInput, useJapanPostalCode } from "@cp949/japanpost-react/client";
+import { normalizeJapanPostalCode, type JapanAddressDataSource } from "@cp949/japanpost-react";
+```
+
 ## What The Package Provides
 
 - Hooks for postal-code lookup and address search:
@@ -163,6 +183,10 @@ The example paths above match this repository's reference backend. In your own
 app, the backend routes can be different as long as your `dataSource`
 implementation returns the same public types.
 
+In Next.js, keep the `dataSource` implementation pointed at your own server-side
+API routes. Do not expose Japan Post credentials or token exchange logic to the
+browser.
+
 ## Core Contract
 
 `Page<T>` is the result shape shared by the hooks and the reference backend:

package/dist/client.d.ts

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

package/dist/client.es.js

@@ -0,0 +1,3 @@
+"use client";
+
+export * from "./index.es.js";

package/dist/index.es.js

@@ -1,255 +1,77 @@
 import { useCallback as e, useEffect as t, useMemo as n, useRef as r, useState as i } from "react";
-//#region \0rolldown/runtime.js
-var a = (e, t) => () => (t || e((t = { exports: {} }).exports, t), t.exports), o = /* @__PURE__ */ ((e) => typeof require < "u" ? require : typeof Proxy < "u" ? new Proxy(e, { get: (e, t) => (typeof require < "u" ? require : e)[t] }) : e)(function(e) {
-	if (typeof require < "u") return require.apply(this, arguments);
-	throw Error("Calling `require` for \"" + e + "\" in an environment that doesn't expose the `require` function. See https://rolldown.rs/in-depth/bundling-cjs#require-external-modules for more details.");
-}), s = /* @__PURE__ */ a(((e) => {
-	var t = Symbol.for("react.transitional.element"), n = Symbol.for("react.fragment");
-	function r(e, n, r) {
-		var i = null;
-		if (r !== void 0 && (i = "" + r), n.key !== void 0 && (i = "" + n.key), "key" in n) for (var a in r = {}, n) a !== "key" && (r[a] = n[a]);
-		else r = n;
-		return n = r.ref, {
-			$$typeof: t,
-			type: e,
-			key: i,
-			ref: n === void 0 ? null : n,
-			props: r
-		};
-	}
-	e.Fragment = n, e.jsx = r, e.jsxs = r;
-})), c = /* @__PURE__ */ a(((e) => {
-	process.env.NODE_ENV !== "production" && (function() {
-		function t(e) {
-			if (e == null) return null;
-			if (typeof e == "function") return e.$$typeof === k ? null : e.displayName || e.name || null;
-			if (typeof e == "string") return e;
-			switch (e) {
-				case v: return "Fragment";
-				case b: return "Profiler";
-				case y: return "StrictMode";
-				case w: return "Suspense";
-				case T: return "SuspenseList";
-				case O: return "Activity";
-			}
-			if (typeof e == "object") switch (typeof e.tag == "number" && console.error("Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."), e.$$typeof) {
-				case _: return "Portal";
-				case S: return e.displayName || "Context";
-				case x: return (e._context.displayName || "Context") + ".Consumer";
-				case C:
-					var n = e.render;
-					return e = e.displayName, e ||= (e = n.displayName || n.name || "", e === "" ? "ForwardRef" : "ForwardRef(" + e + ")"), e;
-				case E: return n = e.displayName || null, n === null ? t(e.type) || "Memo" : n;
-				case D:
-					n = e._payload, e = e._init;
-					try {
-						return t(e(n));
-					} catch {}
-			}
-			return null;
-		}
-		function n(e) {
-			return "" + e;
-		}
-		function r(e) {
-			try {
-				n(e);
-				var t = !1;
-			} catch {
-				t = !0;
-			}
-			if (t) {
-				t = console;
-				var r = t.error, i = typeof Symbol == "function" && Symbol.toStringTag && e[Symbol.toStringTag] || e.constructor.name || "Object";
-				return r.call(t, "The provided key is an unsupported type %s. This value must be coerced to a string before using it here.", i), n(e);
-			}
-		}
-		function i(e) {
-			if (e === v) return "<>";
-			if (typeof e == "object" && e && e.$$typeof === D) return "<...>";
-			try {
-				var n = t(e);
-				return n ? "<" + n + ">" : "<...>";
-			} catch {
-				return "<...>";
-			}
-		}
-		function a() {
-			var e = A.A;
-			return e === null ? null : e.getOwner();
-		}
-		function s() {
-			return Error("react-stack-top-frame");
-		}
-		function c(e) {
-			if (j.call(e, "key")) {
-				var t = Object.getOwnPropertyDescriptor(e, "key").get;
-				if (t && t.isReactWarning) return !1;
-			}
-			return e.key !== void 0;
-		}
-		function l(e, t) {
-			function n() {
-				P || (P = !0, console.error("%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://react.dev/link/special-props)", t));
-			}
-			n.isReactWarning = !0, Object.defineProperty(e, "key", {
-				get: n,
-				configurable: !0
-			});
-		}
-		function u() {
-			var e = t(this.type);
-			return F[e] || (F[e] = !0, console.error("Accessing element.ref was removed in React 19. ref is now a regular prop. It will be removed from the JSX Element type in a future release.")), e = this.props.ref, e === void 0 ? null : e;
-		}
-		function d(e, t, n, r, i, a) {
-			var o = n.ref;
-			return e = {
-				$$typeof: g,
-				type: e,
-				key: t,
-				props: n,
-				_owner: r
-			}, (o === void 0 ? null : o) === null ? Object.defineProperty(e, "ref", {
-				enumerable: !1,
-				value: null
-			}) : Object.defineProperty(e, "ref", {
-				enumerable: !1,
-				get: u
-			}), e._store = {}, Object.defineProperty(e._store, "validated", {
-				configurable: !1,
-				enumerable: !1,
-				writable: !0,
-				value: 0
-			}), Object.defineProperty(e, "_debugInfo", {
-				configurable: !1,
-				enumerable: !1,
-				writable: !0,
-				value: null
-			}), Object.defineProperty(e, "_debugStack", {
-				configurable: !1,
-				enumerable: !1,
-				writable: !0,
-				value: i
-			}), Object.defineProperty(e, "_debugTask", {
-				configurable: !1,
-				enumerable: !1,
-				writable: !0,
-				value: a
-			}), Object.freeze && (Object.freeze(e.props), Object.freeze(e)), e;
-		}
-		function f(e, n, i, o, s, u) {
-			var f = n.children;
-			if (f !== void 0) if (o) if (M(f)) {
-				for (o = 0; o < f.length; o++) p(f[o]);
-				Object.freeze && Object.freeze(f);
-			} else console.error("React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead.");
-			else p(f);
-			if (j.call(n, "key")) {
-				f = t(e);
-				var m = Object.keys(n).filter(function(e) {
-					return e !== "key";
-				});
-				o = 0 < m.length ? "{key: someKey, " + m.join(": ..., ") + ": ...}" : "{key: someKey}", R[f + o] || (m = 0 < m.length ? "{" + m.join(": ..., ") + ": ...}" : "{}", console.error("A props object containing a \"key\" prop is being spread into JSX:\n  let props = %s;\n  <%s {...props} />\nReact keys must be passed directly to JSX without using spread:\n  let props = %s;\n  <%s key={someKey} {...props} />", o, f, m, f), R[f + o] = !0);
-			}
-			if (f = null, i !== void 0 && (r(i), f = "" + i), c(n) && (r(n.key), f = "" + n.key), "key" in n) for (var h in i = {}, n) h !== "key" && (i[h] = n[h]);
-			else i = n;
-			return f && l(i, typeof e == "function" ? e.displayName || e.name || "Unknown" : e), d(e, f, i, a(), s, u);
-		}
-		function p(e) {
-			m(e) ? e._store && (e._store.validated = 1) : typeof e == "object" && e && e.$$typeof === D && (e._payload.status === "fulfilled" ? m(e._payload.value) && e._payload.value._store && (e._payload.value._store.validated = 1) : e._store && (e._store.validated = 1));
-		}
-		function m(e) {
-			return typeof e == "object" && !!e && e.$$typeof === g;
-		}
-		var h = o("react"), g = Symbol.for("react.transitional.element"), _ = Symbol.for("react.portal"), v = Symbol.for("react.fragment"), y = Symbol.for("react.strict_mode"), b = Symbol.for("react.profiler"), x = Symbol.for("react.consumer"), S = Symbol.for("react.context"), C = Symbol.for("react.forward_ref"), w = Symbol.for("react.suspense"), T = Symbol.for("react.suspense_list"), E = Symbol.for("react.memo"), D = Symbol.for("react.lazy"), O = Symbol.for("react.activity"), k = Symbol.for("react.client.reference"), A = h.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE, j = Object.prototype.hasOwnProperty, M = Array.isArray, N = console.createTask ? console.createTask : function() {
-			return null;
-		};
-		h = { react_stack_bottom_frame: function(e) {
-			return e();
-		} };
-		var P, F = {}, I = h.react_stack_bottom_frame.bind(h, s)(), L = N(i(s)), R = {};
-		e.Fragment = v, e.jsx = function(e, t, n) {
-			var r = 1e4 > A.recentlyCreatedOwnerStacks++;
-			return f(e, t, n, !1, r ? Error("react-stack-top-frame") : I, r ? N(i(e)) : L);
-		}, e.jsxs = function(e, t, n) {
-			var r = 1e4 > A.recentlyCreatedOwnerStacks++;
-			return f(e, t, n, !0, r ? Error("react-stack-top-frame") : I, r ? N(i(e)) : L);
-		};
-	})();
-})), l = (/* @__PURE__ */ a(((e, t) => {
-	process.env.NODE_ENV === "production" ? t.exports = s() : t.exports = c();
-})))();
-function u({ defaultValue: e = "", value: t, disabled: n, label: r = "Address keyword", buttonLabel: a = "Search", inputProps: o, buttonProps: s, onChange: c, onSearch: u }) {
-	let [d, f] = i(e), p = t ?? d;
-	function m(e) {
-		e.preventDefault(), u(p.trim());
-	}
+import { jsx as a, jsxs as o } from "react/jsx-runtime";
+//#region src/components/AddressSearchInput.tsx
+function s({ defaultValue: e = "", value: t, disabled: n, label: r = "Address keyword", buttonLabel: s = "Search", inputProps: c, buttonProps: l, onChange: u, onSearch: d }) {
+	let [f, p] = i(e), m = t ?? f;
 	function h(e) {
-		t === void 0 && f(e), c?.(e);
+		e.preventDefault(), d(m.trim());
+	}
+	function g(e) {
+		t === void 0 && p(e), u?.(e);
 	}
-	return /* @__PURE__ */ (0, l.jsxs)("form", {
-		onSubmit: m,
-		children: [/* @__PURE__ */ (0, l.jsxs)("label", { children: [r, /* @__PURE__ */ (0, l.jsx)("input", {
-			...o,
+	return /* @__PURE__ */ o("form", {
+		onSubmit: h,
+		children: [/* @__PURE__ */ o("label", { children: [r, /* @__PURE__ */ a("input", {
+			...c,
 			disabled: n,
-			value: p,
-			onChange: (e) => h(e.target.value)
-		})] }), /* @__PURE__ */ (0, l.jsx)("button", {
-			...s,
+			value: m,
+			onChange: (e) => g(e.target.value)
+		})] }), /* @__PURE__ */ a("button", {
+			...l,
 			disabled: n,
 			type: "submit",
-			children: a
+			children: s
 		})]
 	});
 }
 //#endregion
 //#region src/core/formatters.ts
-function d(e) {
+function c(e) {
 	return e.replace(/[^\d]/g, "");
 }
-function f(e) {
-	let t = d(e);
+function l(e) {
+	let t = c(e);
 	return t.length === 7 ? `${t.slice(0, 3)}-${t.slice(3)}` : t;
 }
 //#endregion
 //#region src/components/PostalCodeInput.tsx
-function p({ defaultValue: e = "", value: t, disabled: n, label: r = "Postal code", buttonLabel: a = "Search", inputProps: o, buttonProps: s, onChange: c, onSearch: u }) {
-	let [f, p] = i(e), m = t ?? f;
-	function h(e) {
-		e.preventDefault(), u(d(m));
-	}
+function u({ defaultValue: e = "", value: t, disabled: n, label: r = "Postal code", buttonLabel: s = "Search", inputProps: l, buttonProps: u, onChange: d, onSearch: f }) {
+	let [p, m] = i(e), h = t ?? p;
 	function g(e) {
-		t === void 0 && p(e), c?.(e);
+		e.preventDefault(), f(c(h));
 	}
-	return /* @__PURE__ */ (0, l.jsxs)("form", {
-		onSubmit: h,
-		children: [/* @__PURE__ */ (0, l.jsxs)("label", { children: [r, /* @__PURE__ */ (0, l.jsx)("input", {
-			...o,
+	function _(e) {
+		t === void 0 && m(e), d?.(e);
+	}
+	return /* @__PURE__ */ o("form", {
+		onSubmit: g,
+		children: [/* @__PURE__ */ o("label", { children: [r, /* @__PURE__ */ a("input", {
+			...l,
 			disabled: n,
-			inputMode: o?.inputMode ?? "numeric",
-			value: m,
-			onChange: (e) => g(e.target.value)
-		})] }), /* @__PURE__ */ (0, l.jsx)("button", {
-			...s,
+			inputMode: l?.inputMode ?? "numeric",
+			value: h,
+			onChange: (e) => _(e.target.value)
+		})] }), /* @__PURE__ */ a("button", {
+			...u,
 			disabled: n,
 			type: "submit",
-			children: a
+			children: s
 		})]
 	});
 }
 //#endregion
 //#region src/core/errors.ts
-function m(e, t, n) {
+function d(e, t, n) {
 	let r = Error(t);
 	return r.name = "JapanAddressError", r.code = e, r.cause = n?.cause, r.status = n?.status, r;
 }
 //#endregion
 //#region src/core/normalizers.ts
-function h(e) {
+function f(e) {
 	return e.filter(Boolean).join(" ").trim();
 }
-function g(e) {
-	let t = h([
+function p(e) {
+	let t = f([
 		e.prefecture,
 		e.city,
 		e.town,
@@ -269,17 +91,17 @@ function g(e) {
 }
 //#endregion
 //#region src/core/validators.ts
-function _(e) {
-	return /^\d{7}$/.test(d(e));
+function m(e) {
+	return /^\d{7}$/.test(c(e));
 }
 //#endregion
 //#region src/react/toJapanAddressError.ts
-function v(e) {
-	return typeof e == "object" && e && "code" in e && typeof e.code == "string" ? e : m("data_source_error", e instanceof Error ? e.message : "Unknown error", { cause: e });
+function h(e) {
+	return typeof e == "object" && e && "code" in e && typeof e.code == "string" ? e : d("data_source_error", e instanceof Error ? e.message : "Unknown error", { cause: e });
 }
 //#endregion
 //#region src/react/useLatestRequestState.ts
-function y() {
+function g() {
 	let n = r(0), a = r(!0), o = r(null), [s, c] = i(!1), [l, u] = i(null), [d, f] = i(null), p = e((e) => a.current && e === n.current, []), m = e(() => {
 		n.current += 1, o.current?.abort(), o.current = null;
 	}, []);
@@ -317,15 +139,15 @@ function y() {
 }
 //#endregion
 //#region src/react/useJapanAddressSearch.ts
-function b(e) {
+function _(e) {
 	if (e) return e;
 	throw Error("useJapanAddressSearch requires options.dataSource");
 }
-function x(e) {
+function v(e) {
 	return e?.trim() || void 0;
 }
-function S(e) {
-	let t = typeof e == "string" ? { addressQuery: e } : e, n = x(t.addressQuery), r = x(t.prefCode), i = x(t.prefName), a = x(t.prefKana), o = x(t.prefRoma), s = x(t.cityCode), c = x(t.cityName), l = x(t.cityKana), u = x(t.cityRoma), d = x(t.townName), f = x(t.townKana), p = x(t.townRoma);
+function y(e) {
+	let t = typeof e == "string" ? { addressQuery: e } : e, n = v(t.addressQuery), r = v(t.prefCode), i = v(t.prefName), a = v(t.prefKana), o = v(t.prefRoma), s = v(t.cityCode), c = v(t.cityName), l = v(t.cityKana), u = v(t.cityRoma), d = v(t.townName), f = v(t.townKana), p = v(t.townRoma);
 	return n === void 0 && r === void 0 && i === void 0 && a === void 0 && o === void 0 && s === void 0 && c === void 0 && l === void 0 && u === void 0 && d === void 0 && f === void 0 && p === void 0 ? null : {
 		...n === void 0 ? {} : { addressQuery: n },
 		...r === void 0 ? {} : { prefCode: r },
@@ -345,7 +167,7 @@ function S(e) {
 		...t.includePrefectureDetails === void 0 ? {} : { includePrefectureDetails: t.includePrefectureDetails }
 	};
 }
-function C(e) {
+function b(e) {
 	return e.aborted ? Promise.resolve(null) : new Promise((t) => {
 		let n = () => {
 			e.removeEventListener("abort", n), t(null);
@@ -353,43 +175,43 @@ function C(e) {
 		e.addEventListener("abort", n, { once: !0 });
 	});
 }
-function w(i) {
-	let a = n(() => b(i.dataSource), [i.dataSource]), o = i.debounceMs ?? 0, s = r(null), c = r(null), { loading: l, data: u, error: d, beginRequest: f, setSuccess: p, setFailure: h, finishRequest: g, cancel: _, reset: x } = y(), w = e((e) => {
+function x(i) {
+	let a = n(() => _(i.dataSource), [i.dataSource]), o = i.debounceMs ?? 0, s = r(null), c = r(null), { loading: l, data: u, error: f, beginRequest: p, setSuccess: m, setFailure: v, finishRequest: x, cancel: S, reset: C } = g(), w = e((e) => {
 		s.current !== null && (globalThis.clearTimeout(s.current), s.current = null), c.current?.(e), c.current = null;
 	}, []);
 	t(() => () => {
 		w(null);
 	}, [w]);
 	let T = e(() => {
-		w(null), x();
-	}, [w, x]), E = e(() => {
-		w(null), _();
-	}, [w, _]), D = e(async (e, t, n) => {
+		w(null), C();
+	}, [w, C]), E = e(() => {
+		w(null), S();
+	}, [w, S]), D = e(async (e, t, n) => {
 		try {
-			let r = { signal: t }, i = a.searchAddress(n, r), o = await Promise.race([i, C(t)]);
-			return t.aborted || o === null ? null : (p(e, o), o);
+			let r = { signal: t }, i = a.searchAddress(n, r), o = await Promise.race([i, b(t)]);
+			return t.aborted || o === null ? null : (m(e, o), o);
 		} catch (n) {
-			return t.aborted ? null : h(e, v(n));
+			return t.aborted ? null : v(e, h(n));
 		} finally {
-			g(e);
+			x(e);
 		}
 	}, [
 		a,
-		g,
-		h,
-		p
+		x,
+		v,
+		m
 	]);
 	return {
 		loading: l,
 		data: u,
-		error: d,
+		error: f,
 		cancel: E,
 		reset: T,
 		search: e((e) => {
-			let t = S(e), { requestId: n, signal: r } = f();
+			let t = y(e), { requestId: n, signal: r } = p();
 			if (w(null), t === null) {
-				let e = h(n, m("invalid_query", "Address query is required"));
-				return g(n), Promise.resolve(e);
+				let e = v(n, d("invalid_query", "Address query is required"));
+				return x(n), Promise.resolve(e);
 			}
 			return o <= 0 ? new Promise((e) => {
 				c.current = e, D(n, r, t).then((t) => {
@@ -405,7 +227,7 @@ function w(i) {
 				}, o);
 			});
 		}, [
-			f,
+			p,
 			w,
 			o,
 			D
@@ -414,51 +236,51 @@ function w(i) {
 }
 //#endregion
 //#region src/react/useJapanPostalCode.ts
-function T(e) {
+function S(e) {
 	if (e) return e;
 	throw Error("useJapanPostalCode requires options.dataSource");
 }
-function E(t) {
-	let r = n(() => T(t.dataSource), [t.dataSource]), { loading: i, data: a, error: o, beginRequest: s, setSuccess: c, setFailure: l, finishRequest: u, cancel: f, reset: p } = y();
+function C(t) {
+	let r = n(() => S(t.dataSource), [t.dataSource]), { loading: i, data: a, error: o, beginRequest: s, setSuccess: l, setFailure: u, finishRequest: f, cancel: p, reset: m } = g();
 	return {
 		loading: i,
 		data: a,
 		error: o,
-		cancel: f,
-		reset: p,
+		cancel: p,
+		reset: m,
 		search: e(async (e) => {
 			let { requestId: t, signal: n } = s();
 			try {
-				let i = typeof e == "string" ? { postalCode: e } : e, a = d(i.postalCode);
-				if (!/^\d{3,7}$/.test(a)) throw m("invalid_postal_code", "Postal code must contain between 3 and 7 digits");
+				let i = typeof e == "string" ? { postalCode: e } : e, a = c(i.postalCode);
+				if (!/^\d{3,7}$/.test(a)) throw d("invalid_postal_code", "Postal code must contain between 3 and 7 digits");
 				let o = { signal: n }, s = {
 					postalCode: a,
 					pageNumber: i.pageNumber ?? 0,
 					rowsPerPage: i.rowsPerPage ?? 100,
 					...i.includeParenthesesTown === void 0 ? {} : { includeParenthesesTown: i.includeParenthesesTown }
-				}, l = await r.lookupPostalCode(s, o);
-				return n.aborted ? null : (c(t, l), l);
+				}, u = await r.lookupPostalCode(s, o);
+				return n.aborted ? null : (l(t, u), u);
 			} catch (e) {
-				return n.aborted ? null : l(t, v(e));
+				return n.aborted ? null : u(t, h(e));
 			} finally {
-				u(t);
+				f(t);
 			}
 		}, [
 			s,
 			r,
+			f,
 			u,
-			l,
-			c
+			l
 		])
 	};
 }
 //#endregion
 //#region src/react/useJapanAddress.ts
-function D(t) {
+function w(t) {
 	let r = n(() => {
 		if (t.dataSource) return t.dataSource;
 		throw Error("useJapanAddress requires options.dataSource");
-	}, [t.dataSource]), a = E({ dataSource: r }), o = w({
+	}, [t.dataSource]), a = C({ dataSource: r }), o = x({
 		dataSource: r,
 		debounceMs: t.debounceMs
 	}), s = a.reset, c = a.search, l = o.reset, u = o.search, [d, f] = i(null), p = e(async (e) => (l(), f("postalCode"), c(e)), [l, c]), m = e(async (e) => (s(), f("addressQuery"), u(e)), [s, u]), h = e(() => {
@@ -474,4 +296,4 @@ function D(t) {
 	};
 }
 //#endregion
-export { u as AddressSearchInput, p as PostalCodeInput, m as createJapanAddressError, f as formatJapanPostalCode, _ as isValidJapanPostalCode, g as normalizeJapanPostAddressRecord, d as normalizeJapanPostalCode, D as useJapanAddress, w as useJapanAddressSearch, E as useJapanPostalCode };
+export { s as AddressSearchInput, u as PostalCodeInput, d as createJapanAddressError, l as formatJapanPostalCode, m as isValidJapanPostalCode, p as normalizeJapanPostAddressRecord, c as normalizeJapanPostalCode, w as useJapanAddress, x as useJapanAddressSearch, C as useJapanPostalCode };

package/dist/src/client.d.ts

@@ -0,0 +1,7 @@
+export { AddressSearchInput } from './components/AddressSearchInput';
+export { PostalCodeInput } from './components/PostalCodeInput';
+export { useJapanAddress } from './react/useJapanAddress';
+export { useJapanAddressSearch } from './react/useJapanAddressSearch';
+export { useJapanPostalCode } from './react/useJapanPostalCode';
+export type * from './core/types';
+//# sourceMappingURL=client.d.ts.map

package/dist/src/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,mBAAmB,cAAc,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cp949/japanpost-react",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Headless React hooks and optional components for Japan Post postcode and address search",
   "type": "module",
   "author": "cp949",
@@ -13,7 +13,7 @@
   "bugs": {
     "url": "https://github.com/cp949/japanpost-react/issues"
   },
-  "main": "dist/index.umd.cjs",
+  "main": "dist/index.es.js",
   "module": "dist/index.es.js",
   "types": "dist/index.d.ts",
   "sideEffects": false,
@@ -31,8 +31,11 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.es.js",
-      "require": "./dist/index.umd.cjs"
+      "import": "./dist/index.es.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.es.js"
     }
   },
   "keywords": [
@@ -64,7 +67,7 @@
   },
   "scripts": {
     "dev": "vite build --watch",
-    "build": "tsc && vite build",
+    "build": "tsc && vite build && node scripts/postbuild-client.mjs",
     "release": "pnpm --dir ../.. readme:package && pnpm --dir ../.. test && pnpm build && pnpm publish --access public --no-git-checks",
     "preview": "vite preview",
     "lint": "biome lint .",

package/dist/index.umd.cjs

@@ -1,6 +0,0 @@
-(function(e,t){typeof exports==`object`&&typeof module<`u`?t(exports,require(`react`)):typeof define==`function`&&define.amd?define([`exports`,`react`],t):(e=typeof globalThis<`u`?globalThis:e||self,t(e.JapanPostcodeReact={},e.React))})(this,function(e,t){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var n=(e,t)=>()=>(t||e((t={exports:{}}).exports,t),t.exports),r=n((e=>{var t=Symbol.for(`react.transitional.element`),n=Symbol.for(`react.fragment`);function r(e,n,r){var i=null;if(r!==void 0&&(i=``+r),n.key!==void 0&&(i=``+n.key),`key`in n)for(var a in r={},n)a!==`key`&&(r[a]=n[a]);else r=n;return n=r.ref,{$$typeof:t,type:e,key:i,ref:n===void 0?null:n,props:r}}e.Fragment=n,e.jsx=r,e.jsxs=r})),i=n((e=>{process.env.NODE_ENV!==`production`&&(function(){function t(e){if(e==null)return null;if(typeof e==`function`)return e.$$typeof===O?null:e.displayName||e.name||null;if(typeof e==`string`)return e;switch(e){case _:return`Fragment`;case y:return`Profiler`;case v:return`StrictMode`;case C:return`Suspense`;case w:return`SuspenseList`;case D:return`Activity`}if(typeof e==`object`)switch(typeof e.tag==`number`&&console.error(`Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue.`),e.$$typeof){case g:return`Portal`;case x:return e.displayName||`Context`;case b:return(e._context.displayName||`Context`)+`.Consumer`;case S:var n=e.render;return e=e.displayName,e||=(e=n.displayName||n.name||``,e===``?`ForwardRef`:`ForwardRef(`+e+`)`),e;case T:return n=e.displayName||null,n===null?t(e.type)||`Memo`:n;case E:n=e._payload,e=e._init;try{return t(e(n))}catch{}}return null}function n(e){return``+e}function r(e){try{n(e);var t=!1}catch{t=!0}if(t){t=console;var r=t.error,i=typeof Symbol==`function`&&Symbol.toStringTag&&e[Symbol.toStringTag]||e.constructor.name||`Object`;return r.call(t,`The provided key is an unsupported type %s. This value must be coerced to a string before using it here.`,i),n(e)}}function i(e){if(e===_)return`<>`;if(typeof e==`object`&&e&&e.$$typeof===E)return`<...>`;try{var n=t(e);return n?`<`+n+`>`:`<...>`}catch{return`<...>`}}function a(){var e=k.A;return e===null?null:e.getOwner()}function o(){return Error(`react-stack-top-frame`)}function s(e){if(A.call(e,`key`)){var t=Object.getOwnPropertyDescriptor(e,`key`).get;if(t&&t.isReactWarning)return!1}return e.key!==void 0}function c(e,t){function n(){N||(N=!0,console.error("%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://react.dev/link/special-props)",t))}n.isReactWarning=!0,Object.defineProperty(e,`key`,{get:n,configurable:!0})}function l(){var e=t(this.type);return P[e]||(P[e]=!0,console.error(`Accessing element.ref was removed in React 19. ref is now a regular prop. It will be removed from the JSX Element type in a future release.`)),e=this.props.ref,e===void 0?null:e}function u(e,t,n,r,i,a){var o=n.ref;return e={$$typeof:h,type:e,key:t,props:n,_owner:r},(o===void 0?null:o)===null?Object.defineProperty(e,`ref`,{enumerable:!1,value:null}):Object.defineProperty(e,`ref`,{enumerable:!1,get:l}),e._store={},Object.defineProperty(e._store,`validated`,{configurable:!1,enumerable:!1,writable:!0,value:0}),Object.defineProperty(e,`_debugInfo`,{configurable:!1,enumerable:!1,writable:!0,value:null}),Object.defineProperty(e,`_debugStack`,{configurable:!1,enumerable:!1,writable:!0,value:i}),Object.defineProperty(e,`_debugTask`,{configurable:!1,enumerable:!1,writable:!0,value:a}),Object.freeze&&(Object.freeze(e.props),Object.freeze(e)),e}function d(e,n,i,o,l,d){var p=n.children;if(p!==void 0)if(o)if(j(p)){for(o=0;o<p.length;o++)f(p[o]);Object.freeze&&Object.freeze(p)}else console.error(`React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead.`);else f(p);if(A.call(n,`key`)){p=t(e);var m=Object.keys(n).filter(function(e){return e!==`key`});o=0<m.length?`{key: someKey, `+m.join(`: ..., `)+`: ...}`:`{key: someKey}`,L[p+o]||(m=0<m.length?`{`+m.join(`: ..., `)+`: ...}`:`{}`,console.error(`A props object containing a "key" prop is being spread into JSX:
-  let props = %s;
-  <%s {...props} />
-React keys must be passed directly to JSX without using spread:
-  let props = %s;
-  <%s key={someKey} {...props} />`,o,p,m,p),L[p+o]=!0)}if(p=null,i!==void 0&&(r(i),p=``+i),s(n)&&(r(n.key),p=``+n.key),`key`in n)for(var h in i={},n)h!==`key`&&(i[h]=n[h]);else i=n;return p&&c(i,typeof e==`function`?e.displayName||e.name||`Unknown`:e),u(e,p,i,a(),l,d)}function f(e){p(e)?e._store&&(e._store.validated=1):typeof e==`object`&&e&&e.$$typeof===E&&(e._payload.status===`fulfilled`?p(e._payload.value)&&e._payload.value._store&&(e._payload.value._store.validated=1):e._store&&(e._store.validated=1))}function p(e){return typeof e==`object`&&!!e&&e.$$typeof===h}var m=require(`react`),h=Symbol.for(`react.transitional.element`),g=Symbol.for(`react.portal`),_=Symbol.for(`react.fragment`),v=Symbol.for(`react.strict_mode`),y=Symbol.for(`react.profiler`),b=Symbol.for(`react.consumer`),x=Symbol.for(`react.context`),S=Symbol.for(`react.forward_ref`),C=Symbol.for(`react.suspense`),w=Symbol.for(`react.suspense_list`),T=Symbol.for(`react.memo`),E=Symbol.for(`react.lazy`),D=Symbol.for(`react.activity`),O=Symbol.for(`react.client.reference`),k=m.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,A=Object.prototype.hasOwnProperty,j=Array.isArray,M=console.createTask?console.createTask:function(){return null};m={react_stack_bottom_frame:function(e){return e()}};var N,P={},F=m.react_stack_bottom_frame.bind(m,o)(),I=M(i(o)),L={};e.Fragment=_,e.jsx=function(e,t,n){var r=1e4>k.recentlyCreatedOwnerStacks++;return d(e,t,n,!1,r?Error(`react-stack-top-frame`):F,r?M(i(e)):I)},e.jsxs=function(e,t,n){var r=1e4>k.recentlyCreatedOwnerStacks++;return d(e,t,n,!0,r?Error(`react-stack-top-frame`):F,r?M(i(e)):I)}})()})),a=n(((e,t)=>{process.env.NODE_ENV===`production`?t.exports=r():t.exports=i()}))();function o({defaultValue:e=``,value:n,disabled:r,label:i=`Address keyword`,buttonLabel:o=`Search`,inputProps:s,buttonProps:c,onChange:l,onSearch:u}){let[d,f]=(0,t.useState)(e),p=n??d;function m(e){e.preventDefault(),u(p.trim())}function h(e){n===void 0&&f(e),l?.(e)}return(0,a.jsxs)(`form`,{onSubmit:m,children:[(0,a.jsxs)(`label`,{children:[i,(0,a.jsx)(`input`,{...s,disabled:r,value:p,onChange:e=>h(e.target.value)})]}),(0,a.jsx)(`button`,{...c,disabled:r,type:`submit`,children:o})]})}function s(e){return e.replace(/[^\d]/g,``)}function c(e){let t=s(e);return t.length===7?`${t.slice(0,3)}-${t.slice(3)}`:t}function l({defaultValue:e=``,value:n,disabled:r,label:i=`Postal code`,buttonLabel:o=`Search`,inputProps:c,buttonProps:l,onChange:u,onSearch:d}){let[f,p]=(0,t.useState)(e),m=n??f;function h(e){e.preventDefault(),d(s(m))}function g(e){n===void 0&&p(e),u?.(e)}return(0,a.jsxs)(`form`,{onSubmit:h,children:[(0,a.jsxs)(`label`,{children:[i,(0,a.jsx)(`input`,{...c,disabled:r,inputMode:c?.inputMode??`numeric`,value:m,onChange:e=>g(e.target.value)})]}),(0,a.jsx)(`button`,{...l,disabled:r,type:`submit`,children:o})]})}function u(e,t,n){let r=Error(t);return r.name=`JapanAddressError`,r.code=e,r.cause=n?.cause,r.status=n?.status,r}function d(e){return e.filter(Boolean).join(` `).trim()}function f(e){let t=d([e.prefecture,e.city,e.town,e.detail??``]);return{postalCode:e.postalCode,prefecture:e.prefecture,prefectureKana:e.prefectureKana,city:e.city,cityKana:e.cityKana,town:e.town,townKana:e.townKana,address:t,provider:`japan-post`}}function p(e){return/^\d{7}$/.test(s(e))}function m(e){return typeof e==`object`&&e&&`code`in e&&typeof e.code==`string`?e:u(`data_source_error`,e instanceof Error?e.message:`Unknown error`,{cause:e})}function h(){let e=(0,t.useRef)(0),n=(0,t.useRef)(!0),r=(0,t.useRef)(null),[i,a]=(0,t.useState)(!1),[o,s]=(0,t.useState)(null),[c,l]=(0,t.useState)(null),u=(0,t.useCallback)(t=>n.current&&t===e.current,[]),d=(0,t.useCallback)(()=>{e.current+=1,r.current?.abort(),r.current=null},[]);(0,t.useEffect)(()=>(n.current=!0,()=>{n.current=!1,d()}),[d]);let f=(0,t.useCallback)(()=>{let t=e.current+1;e.current=t,r.current?.abort();let n=new AbortController;return r.current=n,a(!0),l(null),{requestId:t,signal:n.signal}},[]),p=(0,t.useCallback)((e,t)=>{u(e)&&s(t)},[u]),m=(0,t.useCallback)((e,t)=>(u(e)&&(l(t),s(null)),null),[u]),h=(0,t.useCallback)(()=>{d(),a(!1)},[d]);return{loading:i,data:o,error:c,beginRequest:f,setSuccess:p,setFailure:m,finishRequest:(0,t.useCallback)(e=>{u(e)&&(a(!1),r.current=null)},[u]),cancel:h,reset:(0,t.useCallback)(()=>{h(),s(null),l(null)},[h])}}function g(e){if(e)return e;throw Error(`useJapanAddressSearch requires options.dataSource`)}function _(e){return e?.trim()||void 0}function v(e){let t=typeof e==`string`?{addressQuery:e}:e,n=_(t.addressQuery),r=_(t.prefCode),i=_(t.prefName),a=_(t.prefKana),o=_(t.prefRoma),s=_(t.cityCode),c=_(t.cityName),l=_(t.cityKana),u=_(t.cityRoma),d=_(t.townName),f=_(t.townKana),p=_(t.townRoma);return n===void 0&&r===void 0&&i===void 0&&a===void 0&&o===void 0&&s===void 0&&c===void 0&&l===void 0&&u===void 0&&d===void 0&&f===void 0&&p===void 0?null:{...n===void 0?{}:{addressQuery:n},...r===void 0?{}:{prefCode:r},...i===void 0?{}:{prefName:i},...a===void 0?{}:{prefKana:a},...o===void 0?{}:{prefRoma:o},...s===void 0?{}:{cityCode:s},...c===void 0?{}:{cityName:c},...l===void 0?{}:{cityKana:l},...u===void 0?{}:{cityRoma:u},...d===void 0?{}:{townName:d},...f===void 0?{}:{townKana:f},...p===void 0?{}:{townRoma:p},pageNumber:t.pageNumber??0,rowsPerPage:t.rowsPerPage??100,...t.includeCityDetails===void 0?{}:{includeCityDetails:t.includeCityDetails},...t.includePrefectureDetails===void 0?{}:{includePrefectureDetails:t.includePrefectureDetails}}}function y(e){return e.aborted?Promise.resolve(null):new Promise(t=>{let n=()=>{e.removeEventListener(`abort`,n),t(null)};e.addEventListener(`abort`,n,{once:!0})})}function b(e){let n=(0,t.useMemo)(()=>g(e.dataSource),[e.dataSource]),r=e.debounceMs??0,i=(0,t.useRef)(null),a=(0,t.useRef)(null),{loading:o,data:s,error:c,beginRequest:l,setSuccess:d,setFailure:f,finishRequest:p,cancel:_,reset:b}=h(),x=(0,t.useCallback)(e=>{i.current!==null&&(globalThis.clearTimeout(i.current),i.current=null),a.current?.(e),a.current=null},[]);(0,t.useEffect)(()=>()=>{x(null)},[x]);let S=(0,t.useCallback)(()=>{x(null),b()},[x,b]),C=(0,t.useCallback)(()=>{x(null),_()},[x,_]),w=(0,t.useCallback)(async(e,t,r)=>{try{let i={signal:t},a=n.searchAddress(r,i),o=await Promise.race([a,y(t)]);return t.aborted||o===null?null:(d(e,o),o)}catch(n){return t.aborted?null:f(e,m(n))}finally{p(e)}},[n,p,f,d]);return{loading:o,data:s,error:c,cancel:C,reset:S,search:(0,t.useCallback)(e=>{let t=v(e),{requestId:n,signal:o}=l();if(x(null),t===null){let e=f(n,u(`invalid_query`,`Address query is required`));return p(n),Promise.resolve(e)}return r<=0?new Promise(e=>{a.current=e,w(n,o,t).then(t=>{e(t),a.current===e&&(a.current=null)})}):new Promise(e=>{a.current=e,i.current=globalThis.setTimeout(()=>{i.current=null;let e=a.current;a.current=null,w(n,o,t).then(t=>{e?.(t)})},r)})},[l,x,r,w])}}function x(e){if(e)return e;throw Error(`useJapanPostalCode requires options.dataSource`)}function S(e){let n=(0,t.useMemo)(()=>x(e.dataSource),[e.dataSource]),{loading:r,data:i,error:a,beginRequest:o,setSuccess:c,setFailure:l,finishRequest:d,cancel:f,reset:p}=h();return{loading:r,data:i,error:a,cancel:f,reset:p,search:(0,t.useCallback)(async e=>{let{requestId:t,signal:r}=o();try{let i=typeof e==`string`?{postalCode:e}:e,a=s(i.postalCode);if(!/^\d{3,7}$/.test(a))throw u(`invalid_postal_code`,`Postal code must contain between 3 and 7 digits`);let o={signal:r},l={postalCode:a,pageNumber:i.pageNumber??0,rowsPerPage:i.rowsPerPage??100,...i.includeParenthesesTown===void 0?{}:{includeParenthesesTown:i.includeParenthesesTown}},d=await n.lookupPostalCode(l,o);return r.aborted?null:(c(t,d),d)}catch(e){return r.aborted?null:l(t,m(e))}finally{d(t)}},[o,n,d,l,c])}}function C(e){let n=(0,t.useMemo)(()=>{if(e.dataSource)return e.dataSource;throw Error(`useJapanAddress requires options.dataSource`)},[e.dataSource]),r=S({dataSource:n}),i=b({dataSource:n,debounceMs:e.debounceMs}),a=r.reset,o=r.search,s=i.reset,c=i.search,[l,u]=(0,t.useState)(null),d=(0,t.useCallback)(async e=>(s(),u(`postalCode`),o(e)),[s,o]),f=(0,t.useCallback)(async e=>(a(),u(`addressQuery`),c(e)),[a,c]),p=(0,t.useCallback)(()=>{a(),s(),u(null)},[s,a]),m=l===`postalCode`?r.data:l===`addressQuery`?i.data:null,h=l===`postalCode`?r.error:l===`addressQuery`?i.error:null;return{loading:r.loading||i.loading,data:m,error:h,reset:p,searchByPostalCode:d,searchByAddressQuery:f}}e.AddressSearchInput=o,e.PostalCodeInput=l,e.createJapanAddressError=u,e.formatJapanPostalCode=c,e.isValidJapanPostalCode=p,e.normalizeJapanPostAddressRecord=f,e.normalizeJapanPostalCode=s,e.useJapanAddress=C,e.useJapanAddressSearch=b,e.useJapanPostalCode=S});