@apps-in-toss/native-modules 2.8.0 → 2.9.1

package/dist/bridges-meta.json

@@ -71,6 +71,10 @@
     "identifier": "appLogin",
     "dts": "/**\n * @public\n * @category 로그인\n * @name appLogin\n * @description 토스 인증으로 로그인해요. 로그인이 완료되면 다시 토스 앱으로 이동해요.\n * @example\n *\n * ### 토스 인증을 통해 로그인을 하는 예제\n *\n * ```tsx\n * import { Button } from 'react-native';\n * import { appLogin } from '@apps-in-toss/framework';\n *\n * function Page() {\n *   const handleLogin = async () => {\n *     const { authorizationCode, referrer } = await appLogin();\n *\n *     // 획득한 인가 코드(`authorizationCode`)와 `referrer`를 서버로 전달해요.\n *   }\n *\n *   return <Button title=\"로그인\" onPress={handleLogin} />;\n * }\n * ```\n */\nexport declare function appLogin(): Promise<{\n\tauthorizationCode: string;\n\treferrer: \"DEFAULT\" | \"SANDBOX\";\n}>;\n\nexport {};\n"
   },
+  {
+    "identifier": "getAnonymousKey",
+    "dts": "export interface GetAnonymousKeySuccessResponse {\n\thash: string;\n\ttype: \"HASH\";\n}\nexport type GetAnonymousKeyResponse = GetAnonymousKeySuccessResponse;\n/**\n * @public\n * @name getAnonymousKey\n * @description\n * 미니앱에서 사용자의 고유 키를 가져와요. 이 키를 사용해서 사용자를 식별하고 데이터를 관리할 수 있어요.\n * @returns {Promise<GetAnonymousKeyResponse | 'ERROR' | undefined>}\n * 사용자 키 조회 결과를 반환해요.\n * - `GetAnonymousKeyResponse`: 사용자 키 조회에 성공했어요. `{ type: 'HASH', hash: string }` 형태로 반환돼요.\n * - `'ERROR'`: 알 수 없는 오류가 발생했어요.\n * - `undefined`: 앱 버전이 최소 지원 버전보다 낮아요.\n *\n * @example\n * ```tsx\n * // react-native\n * import { Button } from 'react-native';\n * import { getAnonymousKey } from '@apps-in-toss/framework';\n *\n * function UserKeyButton() {\n *   async function handlePress() {\n *     const result = await getAnonymousKey();\n *\n *     if (!result) {\n *       console.warn('지원하지 않는 앱 버전이에요.');\n *       return;\n *     }\n *\n *     if (result === 'ERROR') {\n *       console.error('사용자 키 조회 중 오류가 발생했어요.');\n *       return;\n *     }\n *\n *     if (result.type === 'HASH') {\n *       console.log('사용자 키:', result.hash);\n *       // 여기에서 사용자 키를 사용해 데이터를 관리할 수 있어요.\n *     }\n *   }\n *\n *   return (\n *     <Button onPress={handlePress} title=\"유저 키 가져오기\" />\n *   );\n * }\n * ```\n *\n * @example\n * ```tsx\n * // webview\n * import { getAnonymousKey } from '@apps-in-toss/web-framework';\n *\n * function UserKeyButton() {\n *   async function handleClick() {\n *     const result = await getAnonymousKey();\n *\n *     if (!result) {\n *       console.warn('지원하지 않는 앱 버전이에요.');\n *       return;\n *     }\n *\n *     if (result === 'ERROR') {\n *       console.error('사용자 키 조회 중 오류가 발생했어요.');\n *       return;\n *     }\n *\n *     if (result.type === 'HASH') {\n *       console.log('사용자 키:', result.hash);\n *       // 여기에서 사용자 키를 사용해 데이터를 관리할 수 있어요.\n *     }\n *   }\n *\n *   return (\n *     <button onClick={handleClick}>유저 키 가져오기</button>\n *   );\n * }\n * ```\n */\nexport declare function getAnonymousKey(): Promise<GetAnonymousKeySuccessResponse | \"ERROR\" | undefined>;\n\nexport {};\n"
+  },
   {
     "identifier": "eventLog",
     "dts": "export type Primitive = string | number | boolean | null | undefined | symbol;\nexport interface EventLogParams {\n\tlog_name: string;\n\tlog_type: \"debug\" | \"info\" | \"warn\" | \"error\" | \"event\" | \"screen\" | \"impression\" | \"click\" | \"popup\";\n\tparams: Record<string, Primitive>;\n}\n/**\n * @category 로깅\n * @kind function\n * @name eventLog\n * @description\n * 이벤트 로그를 기록하는 함수예요.\n *\n * 이 함수는 앱 내에서 발생하는 다양한 이벤트를 로깅하는 데 사용돼요. 디버깅, 정보 제공, 경고, 오류 등 다양한 유형의 로그를 기록할 수 있어요. 샌드박스 환경에서는 콘솔에 로그가 출력되고, 실제 환경에서는 로그 시스템에 기록돼요.\n *\n * @param {Object} params 로그 기록에 필요한 매개변수 객체예요.\n * @param {string} params.log_name 로그의 이름이에요.\n * @param {'debug' | 'info' | 'warn' | 'error' | 'event' | 'screen' | 'impression' | 'click'} params.log_type 로그의 유형이에요.\n * @param {Record<string, Primitive>} params.params 로그에 포함할 추가 매개변수 객체예요.\n *\n * @returns {Promise<void>} 로그 기록이 완료되면 해결되는 Promise예요.\n *\n * @example\n * ### 이벤트 로그 기록하기\n *\n * ```tsx\n * import { eventLog } from '@apps-in-toss/framework';\n *\n * function logUserAction() {\n *   eventLog({\n *     log_name: 'user_action',\n *     log_type: 'info',\n *     params: {\n *       action: 'button_click',\n *       screen: 'main',\n *       userId: 12345\n *     }\n *   });\n * }\n * ```\n */\nexport declare function eventLog(params: EventLogParams): Promise<void>;\n\nexport {};\n"
@@ -119,10 +123,6 @@
     "identifier": "submitGameCenterLeaderBoardScore",
     "dts": "/**\n * @public\n * @category 게임센터\n * @name SubmitGameCenterLeaderBoardScoreResponse\n * @description\n * 토스게임센터 리더보드에 점수를 제출한 결과 정보를 담아서 반환해요. 반환된 정보를 사용해서 점수 제출 결과에 따라 적절한 에러 처리를 할 수 있어요.\n * @property {'SUCCESS' | 'LEADERBOARD_NOT_FOUND' | 'PROFILE_NOT_FOUND' | 'UNPARSABLE_SCORE'} statusCode\n * 점수 제출 결과를 나타내는 상태 코드예요.\n * - `'SUCCESS'`: 점수 제출이 성공했어요.\n * - `'LEADERBOARD_NOT_FOUND'`: `gameId`에 해당하는 리더보드를 찾을 수 없어요.\n * - `'PROFILE_NOT_FOUND'`: 사용자의 프로필이 없어요.\n * - `'UNPARSABLE_SCORE'`: 점수를 해석할 수 없어요. 점수는 실수(float) 형태의 문자열로 전달해야 해요.\n */\nexport interface SubmitGameCenterLeaderBoardScoreResponse {\n\tstatusCode: \"SUCCESS\" | \"LEADERBOARD_NOT_FOUND\" | \"PROFILE_NOT_FOUND\" | \"UNPARSABLE_SCORE\";\n}\n/**\n * @public\n * @category 게임센터\n * @name submitGameCenterLeaderBoardScore\n * @description\n * 사용자의 게임 점수를 토스게임센터 리더보드에 제출해요. 이 기능으로 사용자의 점수를 공식 리더보드에 기록하고 다른 사용자와 비교할 수 있어요.\n * @param {string} params.score\n * 제출할 게임 점수예요. 실수 형태의 숫자를 문자열로 전달해야 해요. 예를들어 `\"123.45\"` 또는 `\"9999\"` 예요.\n * @returns {Promise<SubmitGameCenterLeaderBoardScoreResponse | undefined>}\n * 점수 제출 결과를 반환해요. 앱 버전이 최소 지원 버전보다 낮으면 아무 동작도 하지 않고 `undefined`를 반환해요.\n *\n * @example\n * ### 게임 점수를 토스게임센터 리더보드에 제출하기\n * ```tsx\n * import { Button } from 'react-native';\n * import { submitGameCenterLeaderBoardScore } from '@apps-in-toss/framework';\n *\n * function GameCenterLeaderBoardScoreSubmitButton() {\n *   async function handlePress() {\n *     try {\n *       const result = await submitGameCenterLeaderBoardScore({ score: '123.45' });\n *\n *       if (!result) {\n *         console.warn('지원하지 않는 앱 버전이에요.');\n *         return;\n *       }\n *\n *       if (result.statusCode === 'SUCCESS') {\n *         console.log('점수 제출 성공!');\n *       } else {\n *         console.error('점수 제출 실패:', result.statusCode);\n *       }\n *     } catch (error) {\n *       console.error('점수 제출 중 오류가 발생했어요.', error);\n *     }\n *   }\n *\n *   return (\n *     <Button onPress={handlePress}>점수 제출하기</Button>\n *   );\n * }\n * ```\n */\nexport declare function submitGameCenterLeaderBoardScore(params: {\n\tscore: string;\n}): Promise<SubmitGameCenterLeaderBoardScoreResponse | undefined>;\n\nexport {};\n"
   },
-  {
-    "identifier": "getAnonymousKey",
-    "dts": "export interface GetAnonymousKeySuccessResponse {\n\thash: string;\n\ttype: \"HASH\";\n}\nexport type GetAnonymousKeyResponse = GetAnonymousKeySuccessResponse;\n/**\n * @public\n * @name getAnonymousKey\n * @description\n * 미니앱에서 사용자의 고유 키를 가져와요. 이 키를 사용해서 사용자를 식별하고 데이터를 관리할 수 있어요.\n * @returns {Promise<GetAnonymousKeyResponse | 'ERROR' | undefined>}\n * 사용자 키 조회 결과를 반환해요.\n * - `GetAnonymousKeyResponse`: 사용자 키 조회에 성공했어요. `{ type: 'HASH', hash: string }` 형태로 반환돼요.\n * - `'ERROR'`: 알 수 없는 오류가 발생했어요.\n * - `undefined`: 앱 버전이 최소 지원 버전보다 낮아요.\n *\n * @example\n * ```tsx\n * // react-native\n * import { Button } from 'react-native';\n * import { getAnonymousKey } from '@apps-in-toss/framework';\n *\n * function UserKeyButton() {\n *   async function handlePress() {\n *     const result = await getAnonymousKey();\n *\n *     if (!result) {\n *       console.warn('지원하지 않는 앱 버전이에요.');\n *       return;\n *     }\n *\n *     if (result === 'ERROR') {\n *       console.error('사용자 키 조회 중 오류가 발생했어요.');\n *       return;\n *     }\n *\n *     if (result.type === 'HASH') {\n *       console.log('사용자 키:', result.hash);\n *       // 여기에서 사용자 키를 사용해 데이터를 관리할 수 있어요.\n *     }\n *   }\n *\n *   return (\n *     <Button onPress={handlePress} title=\"유저 키 가져오기\" />\n *   );\n * }\n * ```\n *\n * @example\n * ```tsx\n * // webview\n * import { getAnonymousKey } from '@apps-in-toss/web-framework';\n *\n * function UserKeyButton() {\n *   async function handleClick() {\n *     const result = await getAnonymousKey();\n *\n *     if (!result) {\n *       console.warn('지원하지 않는 앱 버전이에요.');\n *       return;\n *     }\n *\n *     if (result === 'ERROR') {\n *       console.error('사용자 키 조회 중 오류가 발생했어요.');\n *       return;\n *     }\n *\n *     if (result.type === 'HASH') {\n *       console.log('사용자 키:', result.hash);\n *       // 여기에서 사용자 키를 사용해 데이터를 관리할 수 있어요.\n *     }\n *   }\n *\n *   return (\n *     <button onClick={handleClick}>유저 키 가져오기</button>\n *   );\n * }\n * ```\n */\nexport declare function getAnonymousKey(): Promise<GetAnonymousKeySuccessResponse | \"ERROR\" | undefined>;\n\nexport {};\n"
-  },
   {
     "identifier": "getUserKeyForGame",
     "dts": "export interface GetAnonymousKeySuccessResponse {\n\thash: string;\n\ttype: \"HASH\";\n}\nexport type GetAnonymousKeyResponse = GetAnonymousKeySuccessResponse;\n/**\n * @deprecated 이 타입은 더 이상 사용되지 않습니다. 대신 {@link GetAnonymousKeySuccessResponse}를 사용해주세요.\n */\nexport type GetUserKeyForGameSuccessResponse = GetAnonymousKeySuccessResponse;\n/**\n * @deprecated 이 타입은 더 이상 사용되지 않습니다.\n */\nexport type GetUserKeyForGameErrorResponse = {\n\ttype: \"NOT_AVAILABLE\";\n};\n/**\n * @deprecated 이 타입은 더 이상 사용되지 않습니다. 대신 {@link GetAnonymousKeyResponse}를 사용해주세요.\n */\nexport type GetUserKeyForGameResponse = GetAnonymousKeyResponse | GetUserKeyForGameErrorResponse;\n/**\n *\n * @deprecated 이 함수는 더 이상 사용되지 않습니다. 대신 {@link getAnonymousKey}를 사용해주세요.\n */\nexport declare function getUserKeyForGame(): Promise<GetUserKeyForGameSuccessResponse | \"INVALID_CATEGORY\" | \"ERROR\" | undefined>;\n\nexport {};\n"

package/dist/index.cjs

@@ -514,6 +514,45 @@ async function appLogin() {
   return safePostMessage("appLogin", {});
 }
 
+// src/MiniAppModule/constants.ts
+var GAME_CENTER_MIN_VERSION = {
+  android: "5.221.0",
+  ios: "5.221.0"
+};
+var USER_KEY_MIN_VERSION = {
+  android: "5.232.0",
+  ios: "5.232.0"
+};
+var PROMOTION_REWARD_MIN_VERSION = {
+  android: "5.232.0",
+  ios: "5.232.0"
+};
+var GET_IS_TOSS_LOGIN_INTEGRATED_SERVICE_MIN_VERSION = {
+  android: "5.237.0",
+  ios: "5.237.0"
+};
+var GET_SERVER_TIME_MIN_VERSION = {
+  android: "5.245.0",
+  ios: "5.245.0"
+};
+
+// src/MiniAppModule/native-modules/getAnonymousKey.ts
+async function getAnonymousKey() {
+  const isSupported = isMinVersionSupported(USER_KEY_MIN_VERSION);
+  if (!isSupported) {
+    return;
+  }
+  try {
+    const response = await safePostMessage("getUserKeyForGame", {});
+    if (response.type === "HASH") {
+      return response;
+    }
+    return "ERROR";
+  } catch {
+    return "ERROR";
+  }
+}
+
 // src/MiniAppModule/native-modules/eventLog.ts
 function normalizeParams(params) {
   return Object.fromEntries(
@@ -521,11 +560,18 @@ function normalizeParams(params) {
   );
 }
 async function eventLog(params) {
+  const logParams = {
+    anonymous_key: await cache("eventLog.defaultParams.anonymous_key", async () => {
+      const result = await getAnonymousKey();
+      return typeof result === "object" ? result.hash : "NONE";
+    }),
+    ...params.params
+  };
   if (MiniAppModule.getConstants().operationalEnvironment === "sandbox") {
     console.log("[eventLogDebug]", {
       log_name: params.log_name,
       log_type: params.log_type,
-      params: normalizeParams(params.params)
+      params: normalizeParams(logParams)
     });
     return;
   }
@@ -539,9 +585,18 @@ async function eventLog(params) {
   return safePostMessage("eventLog", {
     log_name: params.log_name,
     log_type: params.log_type,
-    params: normalizeParams(params.params)
+    params: normalizeParams(logParams)
   });
 }
+var _cache = {};
+async function cache(key, fetcher) {
+  if (_cache[key]) {
+    return _cache[key];
+  }
+  const value = await fetcher();
+  _cache[key] = value;
+  return value;
+}
 
 // src/MiniAppModule/native-modules/permissions/fetchAlbumPhotos/fetchAlbumPhotos.ts
 var import_types2 = require("@apps-in-toss/types");
@@ -948,30 +1003,6 @@ var Storage = {
 
 // src/MiniAppModule/native-modules/openGameCenterLeaderboard.ts
 var import_react_native7 = require("@granite-js/react-native");
-
-// src/MiniAppModule/constants.ts
-var GAME_CENTER_MIN_VERSION = {
-  android: "5.221.0",
-  ios: "5.221.0"
-};
-var USER_KEY_MIN_VERSION = {
-  android: "5.232.0",
-  ios: "5.232.0"
-};
-var PROMOTION_REWARD_MIN_VERSION = {
-  android: "5.232.0",
-  ios: "5.232.0"
-};
-var GET_IS_TOSS_LOGIN_INTEGRATED_SERVICE_MIN_VERSION = {
-  android: "5.237.0",
-  ios: "5.237.0"
-};
-var GET_SERVER_TIME_MIN_VERSION = {
-  android: "5.245.0",
-  ios: "5.245.0"
-};
-
-// src/MiniAppModule/native-modules/openGameCenterLeaderboard.ts
 async function openGameCenterLeaderboard() {
   if (!isMinVersionSupported(GAME_CENTER_MIN_VERSION)) {
     return;
@@ -1004,23 +1035,6 @@ async function submitGameCenterLeaderBoardScore(params) {
   return safePostMessage("submitGameCenterLeaderBoardScore", params);
 }
 
-// src/MiniAppModule/native-modules/getAnonymousKey.ts
-async function getAnonymousKey() {
-  const isSupported = isMinVersionSupported(USER_KEY_MIN_VERSION);
-  if (!isSupported) {
-    return;
-  }
-  try {
-    const response = await safePostMessage("getUserKeyForGame", {});
-    if (response.type === "HASH") {
-      return response;
-    }
-    return "ERROR";
-  } catch {
-    return "ERROR";
-  }
-}
-
 // src/MiniAppModule/native-modules/getUserKeyForGame.ts
 async function getUserKeyForGame() {
   return getAnonymousKey();

package/dist/index.js

@@ -427,6 +427,45 @@ async function appLogin() {
   return safePostMessage("appLogin", {});
 }
 
+// src/MiniAppModule/constants.ts
+var GAME_CENTER_MIN_VERSION = {
+  android: "5.221.0",
+  ios: "5.221.0"
+};
+var USER_KEY_MIN_VERSION = {
+  android: "5.232.0",
+  ios: "5.232.0"
+};
+var PROMOTION_REWARD_MIN_VERSION = {
+  android: "5.232.0",
+  ios: "5.232.0"
+};
+var GET_IS_TOSS_LOGIN_INTEGRATED_SERVICE_MIN_VERSION = {
+  android: "5.237.0",
+  ios: "5.237.0"
+};
+var GET_SERVER_TIME_MIN_VERSION = {
+  android: "5.245.0",
+  ios: "5.245.0"
+};
+
+// src/MiniAppModule/native-modules/getAnonymousKey.ts
+async function getAnonymousKey() {
+  const isSupported = isMinVersionSupported(USER_KEY_MIN_VERSION);
+  if (!isSupported) {
+    return;
+  }
+  try {
+    const response = await safePostMessage("getUserKeyForGame", {});
+    if (response.type === "HASH") {
+      return response;
+    }
+    return "ERROR";
+  } catch {
+    return "ERROR";
+  }
+}
+
 // src/MiniAppModule/native-modules/eventLog.ts
 function normalizeParams(params) {
   return Object.fromEntries(
@@ -434,11 +473,18 @@ function normalizeParams(params) {
   );
 }
 async function eventLog(params) {
+  const logParams = {
+    anonymous_key: await cache("eventLog.defaultParams.anonymous_key", async () => {
+      const result = await getAnonymousKey();
+      return typeof result === "object" ? result.hash : "NONE";
+    }),
+    ...params.params
+  };
   if (MiniAppModule.getConstants().operationalEnvironment === "sandbox") {
     console.log("[eventLogDebug]", {
       log_name: params.log_name,
       log_type: params.log_type,
-      params: normalizeParams(params.params)
+      params: normalizeParams(logParams)
     });
     return;
   }
@@ -452,9 +498,18 @@ async function eventLog(params) {
   return safePostMessage("eventLog", {
     log_name: params.log_name,
     log_type: params.log_type,
-    params: normalizeParams(params.params)
+    params: normalizeParams(logParams)
   });
 }
+var _cache = {};
+async function cache(key, fetcher) {
+  if (_cache[key]) {
+    return _cache[key];
+  }
+  const value = await fetcher();
+  _cache[key] = value;
+  return value;
+}
 
 // src/MiniAppModule/native-modules/permissions/fetchAlbumPhotos/fetchAlbumPhotos.ts
 import { FetchAlbumPhotosPermissionError } from "@apps-in-toss/types";
@@ -861,30 +916,6 @@ var Storage = {
 
 // src/MiniAppModule/native-modules/openGameCenterLeaderboard.ts
 import { openURL } from "@granite-js/react-native";
-
-// src/MiniAppModule/constants.ts
-var GAME_CENTER_MIN_VERSION = {
-  android: "5.221.0",
-  ios: "5.221.0"
-};
-var USER_KEY_MIN_VERSION = {
-  android: "5.232.0",
-  ios: "5.232.0"
-};
-var PROMOTION_REWARD_MIN_VERSION = {
-  android: "5.232.0",
-  ios: "5.232.0"
-};
-var GET_IS_TOSS_LOGIN_INTEGRATED_SERVICE_MIN_VERSION = {
-  android: "5.237.0",
-  ios: "5.237.0"
-};
-var GET_SERVER_TIME_MIN_VERSION = {
-  android: "5.245.0",
-  ios: "5.245.0"
-};
-
-// src/MiniAppModule/native-modules/openGameCenterLeaderboard.ts
 async function openGameCenterLeaderboard() {
   if (!isMinVersionSupported(GAME_CENTER_MIN_VERSION)) {
     return;
@@ -917,23 +948,6 @@ async function submitGameCenterLeaderBoardScore(params) {
   return safePostMessage("submitGameCenterLeaderBoardScore", params);
 }
 
-// src/MiniAppModule/native-modules/getAnonymousKey.ts
-async function getAnonymousKey() {
-  const isSupported = isMinVersionSupported(USER_KEY_MIN_VERSION);
-  if (!isSupported) {
-    return;
-  }
-  try {
-    const response = await safePostMessage("getUserKeyForGame", {});
-    if (response.type === "HASH") {
-      return response;
-    }
-    return "ERROR";
-  } catch {
-    return "ERROR";
-  }
-}
-
 // src/MiniAppModule/native-modules/getUserKeyForGame.ts
 async function getUserKeyForGame() {
   return getAnonymousKey();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apps-in-toss/native-modules",
   "type": "module",
-  "version": "2.8.0",
+  "version": "2.9.1",
   "description": "Native Modules for Apps In Toss",
   "scripts": {
     "typecheck": "tsc --noEmit",
@@ -42,7 +42,7 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@apps-in-toss/types": "2.8.0",
+    "@apps-in-toss/types": "2.9.1",
     "brick-module": "0.5.2",
     "es-toolkit": "^1.39.3"
   },

package/src/MiniAppModule/native-modules/eventLog.ts

@@ -1,3 +1,4 @@
+import { getAnonymousKey } from './getAnonymousKey';
 import { isMinVersionSupported } from './isMinVersionSupported';
 import { MiniAppModule, safePostMessage } from '../../natives';
 import { Primitive } from '../../types';
@@ -52,11 +53,19 @@ export interface EventLogParams {
  * ```
  */
 export async function eventLog(params: EventLogParams) {
+  const logParams = {
+    anonymous_key: await cache('eventLog.defaultParams.anonymous_key', async () => {
+      const result = await getAnonymousKey();
+      return typeof result === 'object' ? result.hash : 'NONE';
+    }),
+    ...params.params,
+  };
+
   if (MiniAppModule.getConstants().operationalEnvironment === 'sandbox') {
     console.log('[eventLogDebug]', {
       log_name: params.log_name,
       log_type: params.log_type,
-      params: normalizeParams(params.params),
+      params: normalizeParams(logParams),
     });
     return;
   }
@@ -72,6 +81,16 @@ export async function eventLog(params: EventLogParams) {
   return safePostMessage('eventLog', {
     log_name: params.log_name,
     log_type: params.log_type,
-    params: normalizeParams(params.params),
+    params: normalizeParams(logParams),
   });
 }
+
+const _cache: Record<string, any> = {};
+async function cache(key: string, fetcher: () => Promise<any>) {
+  if (_cache[key]) {
+    return _cache[key];
+  }
+  const value = await fetcher();
+  _cache[key] = value;
+  return value;
+}