@readyfor/api-client-base 1.56.0-pr1409.657b73e → 1.56.0-pr1409.ed0166a

package/dist/react/ApiClientConfigProvider.d.ts

@@ -7,9 +7,27 @@ type Configuration = Config & {
   swr?: SWRConfiguration;
 };
 type Props = {
+  /**
+   * API クライアントの設定。
+   *
+   * **安定参照 / 値安定で渡すこと**（`useMemo` を使うか、モジュールスコープの定数にする）。
+   * インライン新オブジェクト（`config={{ ... }}`）を渡すと毎 render で浅い比較が走り、
+   * 値が変わらなくても参照が変わった場合は購読者全体が再 render される。
+   * 関数プロパティ（`onError` など）は参照比較のため、同様に安定参照を推奨する。
+   */
   config: Configuration;
   children: ReactNode;
 };
+/**
+ * API クライアントの設定を子ツリーへ提供するプロバイダ。
+ *
+ * **注意事項**
+ * - `store` は `globalThis` 上の単一シングルトン。複数インスタンスを同時にマウントすると
+ *   後勝ちで上書きされ、意図しない挙動になる。アプリルートに 1 つだけ置くこと。
+ * - **CSR 専用**。SSR（Node / Edge での server render）環境では `store` がリクエスト間で
+ *   共有されるため、config が汚染される。SSR が必要な場合は別途対応を検討すること。
+ * - `config` は安定参照 / 値安定で渡すこと（`Props.config` の JSDoc を参照）。
+ */
 declare const ApiClientConfigProvider: FC<Props>;
 declare const useApiClientConfigContext: () => Store<Config>;
 //#endregion

package/dist/react/ApiClientConfigProvider.js

@@ -6,13 +6,42 @@ let swr = require("swr");
 let react_jsx_runtime = require("react/jsx-runtime");
 //#region src/react/ApiClientConfigProvider.tsx
 const ApiClientConfigContext = (0, react.createContext)(require_apiClientConfigStore.store);
+/**
+* `config` オブジェクトのキー集合と各値を浅く比較する。
+* 関数プロパティは参照比較になる。
+*
+* キー集合の厳密一致を担保するため、長さチェックに加えて
+* b 側に各キーが存在することも確認する。
+*/
+const shallowEqual = (a, b) => {
+	const aKeys = Object.keys(a);
+	const bKeys = Object.keys(b);
+	if (aKeys.length !== bKeys.length) return false;
+	return aKeys.every((k) => Object.prototype.hasOwnProperty.call(b, k) && a[k] === b[k]);
+};
+/**
+* API クライアントの設定を子ツリーへ提供するプロバイダ。
+*
+* **注意事項**
+* - `store` は `globalThis` 上の単一シングルトン。複数インスタンスを同時にマウントすると
+*   後勝ちで上書きされ、意図しない挙動になる。アプリルートに 1 つだけ置くこと。
+* - **CSR 専用**。SSR（Node / Edge での server render）環境では `store` がリクエスト間で
+*   共有されるため、config が汚染される。SSR が必要な場合は別途対応を検討すること。
+* - `config` は安定参照 / 値安定で渡すこと（`Props.config` の JSDoc を参照）。
+*/
 const ApiClientConfigProvider = (props) => {
 	const { swr: swr$1, ...config } = props.config;
 	const prevConfigRef = (0, react.useRef)(null);
-	if (prevConfigRef.current !== config) {
+	if (prevConfigRef.current === null && typeof window !== "undefined") {
 		require_apiClientConfigStore.store.setState(() => config);
 		prevConfigRef.current = config;
 	}
+	(0, react.useEffect)(() => {
+		if (prevConfigRef.current === null || !shallowEqual(prevConfigRef.current, config)) {
+			require_apiClientConfigStore.store.setState(() => config);
+			prevConfigRef.current = config;
+		}
+	});
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ApiClientConfigContext.Provider, {
 		value: require_apiClientConfigStore.store,
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(swr.SWRConfig, {

package/dist/react/index.mjs

@@ -1,5 +1,5 @@
 import { i as mergeRequestInit, r as store } from "../apiClientConfigStore-DDleIkQN.mjs";
-import { createContext, useContext, useMemo, useRef } from "react";
+import { createContext, useContext, useEffect, useMemo, useRef } from "react";
 import { SWRConfig } from "swr";
 import { jsx } from "react/jsx-runtime";
 import { useSyncExternalStore } from "use-sync-external-store/shim/index.js";
@@ -30,13 +30,42 @@ const createSwrConfig = (config) => ({
 //#endregion
 //#region src/react/ApiClientConfigProvider.tsx
 const ApiClientConfigContext = createContext(store);
+/**
+* `config` オブジェクトのキー集合と各値を浅く比較する。
+* 関数プロパティは参照比較になる。
+*
+* キー集合の厳密一致を担保するため、長さチェックに加えて
+* b 側に各キーが存在することも確認する。
+*/
+const shallowEqual = (a, b) => {
+	const aKeys = Object.keys(a);
+	const bKeys = Object.keys(b);
+	if (aKeys.length !== bKeys.length) return false;
+	return aKeys.every((k) => Object.prototype.hasOwnProperty.call(b, k) && a[k] === b[k]);
+};
+/**
+* API クライアントの設定を子ツリーへ提供するプロバイダ。
+*
+* **注意事項**
+* - `store` は `globalThis` 上の単一シングルトン。複数インスタンスを同時にマウントすると
+*   後勝ちで上書きされ、意図しない挙動になる。アプリルートに 1 つだけ置くこと。
+* - **CSR 専用**。SSR（Node / Edge での server render）環境では `store` がリクエスト間で
+*   共有されるため、config が汚染される。SSR が必要な場合は別途対応を検討すること。
+* - `config` は安定参照 / 値安定で渡すこと（`Props.config` の JSDoc を参照）。
+*/
 const ApiClientConfigProvider = (props) => {
 	const { swr, ...config } = props.config;
 	const prevConfigRef = useRef(null);
-	if (prevConfigRef.current !== config) {
+	if (prevConfigRef.current === null && typeof window !== "undefined") {
 		store.setState(() => config);
 		prevConfigRef.current = config;
 	}
+	useEffect(() => {
+		if (prevConfigRef.current === null || !shallowEqual(prevConfigRef.current, config)) {
+			store.setState(() => config);
+			prevConfigRef.current = config;
+		}
+	});
 	return /* @__PURE__ */ jsx(ApiClientConfigContext.Provider, {
 		value: store,
 		children: /* @__PURE__ */ jsx(SWRConfig, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@readyfor/api-client-base",
-  "version": "1.56.0-pr1409.657b73e",
+  "version": "1.56.0-pr1409.ed0166a",
   "license": "SEE LICENSE IN LICENSE.md",
   "main": "dist/index.js",
   "module": "dist/index.mjs",