@ehfuse/forma 2.3.2 → 3.0.0

package/dist/src/utils/persist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist.d.ts","sourceRoot":"","sources":["../../../src/utils/persist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,cAAc,GAAG,gBAAgB,CAAC;CAC/C;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,cAAc,CAAC;AAYpD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,CAK5E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7E;AAqBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3D,MAAM,EAAE,aAAa,EACrB,aAAa,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAiBnB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3D,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,CAAC,EACT,aAAa,CAAC,EAAE,MAAM,GACvB,OAAO,CA4BT;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAC9B,MAAM,EAAE,aAAa,EACrB,aAAa,CAAC,EAAE,MAAM,GACvB,OAAO,CAcT;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC5B,MAAM,EAAE,aAAa,EACrB,aAAa,CAAC,EAAE,MAAM,GACvB,OAAO,CAYT;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACtD,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACd,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAYlC"}

package/dist/src/utils/persist.js

@@ -0,0 +1,163 @@
+"use strict";
+/**
+ * persist.ts
+ *
+ * Forma - localStorage/sessionStorage 영속성 유틸리티
+ * Persistence utilities for localStorage/sessionStorage
+ *
+ * @license MIT License
+ * @copyright 2025 KIM YOUNG JIN (Kim Young Jin)
+ * @author KIM YOUNG JIN (ehfuse@gmail.com)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizePersistConfig = normalizePersistConfig;
+exports.getFullStorageKey = getFullStorageKey;
+exports.loadPersistedData = loadPersistedData;
+exports.savePersistedData = savePersistedData;
+exports.clearPersistedData = clearPersistedData;
+exports.hasPersistedData = hasPersistedData;
+exports.debounce = debounce;
+const environment_1 = require("./environment");
+/**
+ * PersistConfig를 PersistOptions로 정규화
+ * Normalize PersistConfig to PersistOptions
+ */
+function normalizePersistConfig(config) {
+    if (typeof config === "string") {
+        return { key: config };
+    }
+    return config;
+}
+/**
+ * storagePrefix가 적용된 전체 키 생성 | Generate full key with storagePrefix
+ */
+function getFullStorageKey(key, storagePrefix) {
+    return storagePrefix ? `${storagePrefix}:${key}` : key;
+}
+/**
+ * 스토리지 객체 가져오기 | Get storage object
+ */
+function getStorage(type = "localStorage") {
+    if (typeof window === "undefined") {
+        return null;
+    }
+    try {
+        return type === "sessionStorage"
+            ? window.sessionStorage
+            : window.localStorage;
+    }
+    catch {
+        (0, environment_1.devWarn)("Storage is not available");
+        return null;
+    }
+}
+/**
+ * localStorage에서 데이터 불러오기 | Load data from localStorage
+ * @param config persist 설정 | persist configuration
+ * @param storagePrefix 스토리지 키 prefix (GlobalFormaProvider에서 제공) | Storage key prefix (from GlobalFormaProvider)
+ */
+function loadPersistedData(config, storagePrefix) {
+    const options = normalizePersistConfig(config);
+    const storage = getStorage(options.storage);
+    const fullKey = getFullStorageKey(options.key, storagePrefix);
+    if (!storage)
+        return null;
+    try {
+        const stored = storage.getItem(fullKey);
+        if (!stored)
+            return null;
+        const parsed = JSON.parse(stored);
+        return parsed.values;
+    }
+    catch (e) {
+        (0, environment_1.devWarn)(`Failed to load persisted data for key "${fullKey}":`, e);
+        return null;
+    }
+}
+/**
+ * localStorage에 데이터 저장 | Save data to localStorage
+ * @param config persist 설정 | persist configuration
+ * @param values 저장할 값 | values to save
+ * @param storagePrefix 스토리지 키 prefix (GlobalFormaProvider에서 제공) | Storage key prefix (from GlobalFormaProvider)
+ */
+function savePersistedData(config, values, storagePrefix) {
+    const options = normalizePersistConfig(config);
+    const storage = getStorage(options.storage);
+    const fullKey = getFullStorageKey(options.key, storagePrefix);
+    if (!storage)
+        return false;
+    try {
+        // exclude 필드 제외
+        let dataToSave = values;
+        if (options.exclude && options.exclude.length > 0) {
+            dataToSave = { ...values };
+            for (const field of options.exclude) {
+                delete dataToSave[field];
+            }
+        }
+        const data = {
+            values: dataToSave,
+            savedAt: Date.now(),
+        };
+        storage.setItem(fullKey, JSON.stringify(data));
+        return true;
+    }
+    catch (e) {
+        (0, environment_1.devWarn)(`Failed to save persisted data for key "${fullKey}":`, e);
+        return false;
+    }
+}
+/**
+ * localStorage에서 데이터 삭제 | Clear persisted data from localStorage
+ * @param config persist 설정 | persist configuration
+ * @param storagePrefix 스토리지 키 prefix (GlobalFormaProvider에서 제공) | Storage key prefix (from GlobalFormaProvider)
+ */
+function clearPersistedData(config, storagePrefix) {
+    const options = normalizePersistConfig(config);
+    const storage = getStorage(options.storage);
+    const fullKey = getFullStorageKey(options.key, storagePrefix);
+    if (!storage)
+        return false;
+    try {
+        storage.removeItem(fullKey);
+        return true;
+    }
+    catch (e) {
+        (0, environment_1.devWarn)(`Failed to clear persisted data for key "${fullKey}":`, e);
+        return false;
+    }
+}
+/**
+ * 저장된 데이터가 있는지 확인 | Check if persisted data exists
+ * @param config persist 설정 | persist configuration
+ * @param storagePrefix 스토리지 키 prefix (GlobalFormaProvider에서 제공) | Storage key prefix (from GlobalFormaProvider)
+ */
+function hasPersistedData(config, storagePrefix) {
+    const options = normalizePersistConfig(config);
+    const storage = getStorage(options.storage);
+    const fullKey = getFullStorageKey(options.key, storagePrefix);
+    if (!storage)
+        return false;
+    try {
+        return storage.getItem(fullKey) !== null;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 디바운스 유틸리티 | Debounce utility
+ */
+function debounce(fn, delay) {
+    let timeoutId = null;
+    return (...args) => {
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+        }
+        timeoutId = setTimeout(() => {
+            fn(...args);
+            timeoutId = null;
+        }, delay);
+    };
+}
+//# sourceMappingURL=persist.js.map

package/dist/src/utils/persist.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ehfuse/forma",
-    "version": "2.3.2",
+    "version": "3.0.0",
     "description": "Advanced React state management library with individual field subscriptions - supports both forms and general state management with useFormaState",
     "main": "dist/index.js",
     "module": "dist/esm/index.js",