react-state-bucket 1.2.2 → 1.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/index.d.ts CHANGED
@@ -1,28 +1,31 @@
1
1
  type BucketOptions = {
2
2
  store?: "memory" | "session" | "local" | "url";
3
+ onChange?: (key: string, value: any, type: "set" | "delete") => void;
3
4
  };
4
5
  declare const createBucket: <IT extends {
5
6
  [key: string]: any;
6
7
  }>(initial: IT, option?: BucketOptions) => {
7
8
  (): {
8
9
  set: <T extends keyof IT>(key: T, value: IT[T]) => void;
9
- get: <T_1 extends keyof IT>(key: T_1) => IT[T_1];
10
- delete: <T_2 extends keyof IT>(key: T_2) => void;
10
+ get: <T extends keyof IT>(key: T) => IT[T];
11
+ delete: <T extends keyof IT>(key: T) => void;
11
12
  clear: () => void;
12
13
  getState: () => IT;
13
14
  setState: (state: Partial<IT>) => void;
14
- isChange: <T_3 extends keyof IT>(key: T_3) => boolean | undefined;
15
+ isChange: <T extends keyof IT>(key: T) => boolean;
15
16
  getChanges: () => string[];
17
+ clearChange: <T extends keyof IT>(key: T) => Map<string, boolean>;
16
18
  clearChanges: () => void;
17
19
  };
18
20
  set: <T extends keyof IT>(key: T, value: IT[T]) => void;
19
- get: <T_1 extends keyof IT>(key: T_1) => IT[T_1];
20
- delete: <T_2 extends keyof IT>(key: T_2) => void;
21
+ get: <T extends keyof IT>(key: T) => IT[T];
22
+ delete: <T extends keyof IT>(key: T) => void;
21
23
  clear: () => void;
22
24
  getState: () => IT;
23
25
  setState: (state: Partial<IT>) => void;
24
- isChange: <T_3 extends keyof IT>(key: T_3) => boolean | undefined;
26
+ isChange: <T extends keyof IT>(key: T) => boolean;
25
27
  getChanges: () => string[];
28
+ clearChange: <T extends keyof IT>(key: T) => Map<string, boolean>;
26
29
  clearChanges: () => void;
27
30
  };
28
31
 
package/index.js CHANGED
@@ -3,41 +3,6 @@
3
3
  let data = new Map();
4
4
  let changes = new Map();
5
5
  let _option = Object.assign({ store: "memory" }, option);
6
- for (let key in initial) {
7
- let value = initial[key];
8
- data.set(key, value);
9
- changes.set(key, true);
10
- }
11
- const handleStorage = (isLoaded = true) => {
12
- if (typeof window !== 'undefined') {
13
- let url = new URL(window.location.href);
14
- if (_option.store === 'session' || _option.store === 'local') {
15
- let storage = _option.store === "session" ? sessionStorage : localStorage;
16
- for (let key in initial) {
17
- let has = storage.getItem(key) !== null;
18
- if (isLoaded || !has) {
19
- data.has(key) ? storage.setItem(key, data.get(key)) : storage.removeItem(key);
20
- }
21
- else if (has) {
22
- data.set(key, storage.getItem(key));
23
- }
24
- }
25
- }
26
- else if (_option.store === "url") {
27
- for (let key in initial) {
28
- let has = url.searchParams.has(key);
29
- if (isLoaded || !has) {
30
- data.has(key) ? url.searchParams.set(key, data.get(key)) : url.searchParams.delete(key);
31
- }
32
- else if (has) {
33
- data.set(key, url.searchParams.get(key));
34
- }
35
- }
36
- window.history.replaceState(null, '', url.toString());
37
- }
38
- }
39
- };
40
- handleStorage(false);
41
6
  let dispatch = () => {
42
7
  hooks.forEach(d => {
43
8
  try {
@@ -45,24 +10,73 @@
45
10
  }
46
11
  catch (error) { }
47
12
  });
48
- handleStorage();
49
13
  };
50
14
  const set = (key, value) => {
51
15
  if (!(key in initial))
52
16
  throw new Error(`(${key}) Invalid key provided in the set function. Please verify the structure of the initial state data.`);
53
- data.set(key, value);
17
+ if (typeof window !== 'undefined' && (_option.store === 'session' || _option.store === 'local')) {
18
+ let storage = _option.store === "session" ? sessionStorage : localStorage;
19
+ storage.setItem(key, JSON.stringify(value));
20
+ }
21
+ else if (typeof window !== 'undefined' && _option.store === 'url') {
22
+ let url = new URL(window.location.href);
23
+ url.searchParams.set(key, encodeURIComponent(JSON.stringify(value)));
24
+ window.history.replaceState({}, '', url.toString());
25
+ }
26
+ else {
27
+ data.set(key, value);
28
+ }
29
+ if (_option.onChange) {
30
+ _option.onChange(key, value, 'set');
31
+ }
54
32
  changes.set(key, true);
55
33
  dispatch();
56
34
  };
57
- const get = (key) => data.get(key);
58
- const _delete = (key) => {
59
- data.delete(key);
35
+ const get = (key) => {
36
+ if (!(key in initial))
37
+ throw new Error(`(${key}) Invalid key provided in the get function. Please verify the structure of the initial state data.`);
38
+ if (typeof window !== 'undefined' && (_option.store === 'session' || _option.store === 'local')) {
39
+ let storage = _option.store === "session" ? sessionStorage : localStorage;
40
+ let storedValue = storage.getItem(key);
41
+ try {
42
+ return JSON.parse(storedValue);
43
+ }
44
+ catch (_a) {
45
+ return storedValue;
46
+ }
47
+ }
48
+ else if (typeof window !== 'undefined' && _option.store === 'url') {
49
+ let url = new URL(window.location.href);
50
+ let storedValue = url.searchParams.get(key);
51
+ try {
52
+ return JSON.parse(decodeURIComponent(storedValue));
53
+ }
54
+ catch (_b) {
55
+ return storedValue;
56
+ }
57
+ }
58
+ return data.get(key);
59
+ };
60
+ const del = (key) => {
61
+ if (!(key in initial))
62
+ throw new Error(`(${key}) Invalid key provided in the delete function. Please verify the structure of the initial state data.`);
63
+ set(key, undefined);
64
+ if (_option.onChange) {
65
+ _option.onChange(key, undefined, 'delete');
66
+ }
60
67
  changes.set(key, true);
61
68
  dispatch();
62
69
  };
70
+ const has = (key) => {
71
+ const value = get(key);
72
+ return value !== undefined && value !== null;
73
+ };
74
+ const isInitialed = () => {
75
+ return has(Object.keys(initial).shift());
76
+ };
63
77
  const clear = () => {
64
78
  for (let key in initial) {
65
- data.delete(key);
79
+ del(key);
66
80
  changes.set(key, true);
67
81
  }
68
82
  dispatch();
@@ -70,7 +84,7 @@
70
84
  const getState = () => {
71
85
  let d = {};
72
86
  for (let key in initial) {
73
- d[key] = data.get(key);
87
+ d[key] = get(key);
74
88
  }
75
89
  return d;
76
90
  };
@@ -78,14 +92,20 @@
78
92
  for (let key in state) {
79
93
  if (!(key in initial))
80
94
  throw new Error(`(${key}) Invalid key provided in the setState function. Please verify the structure of the initial state data.`);
81
- data.set(key, state[key]);
95
+ set(key, state[key]);
82
96
  changes.set(key, true);
83
97
  }
84
98
  dispatch();
85
99
  };
86
- const isChange = (key) => changes.get(key);
87
- const getChanges = () => Array.from(changes.keys()).filter((key) => changes.get(key));
100
+ const isChange = (key) => changes.get(key) || false;
101
+ const clearChange = (key) => changes.set(key, false);
102
+ const getChanges = () => Array.from(changes.keys()).filter((key) => clearChange(key));
88
103
  const clearChanges = () => Array.from(changes.keys()).forEach((key) => changes.set(key, false));
104
+ if (!isInitialed()) {
105
+ for (let key in initial) {
106
+ set(key, initial[key]);
107
+ }
108
+ }
89
109
  const useHook = () => {
90
110
  const id = react.useId();
91
111
  const [d, setUp] = react.useState(0);
@@ -99,23 +119,25 @@
99
119
  return {
100
120
  set,
101
121
  get,
102
- delete: _delete,
122
+ delete: del,
103
123
  clear,
104
124
  getState: () => state,
105
125
  setState,
106
126
  isChange,
107
127
  getChanges,
128
+ clearChange,
108
129
  clearChanges,
109
130
  };
110
131
  };
111
132
  useHook.set = set;
112
133
  useHook.get = get;
113
- useHook.delete = _delete;
134
+ useHook.delete = del;
114
135
  useHook.clear = clear;
115
136
  useHook.getState = getState;
116
137
  useHook.setState = setState;
117
138
  useHook.isChange = isChange;
118
139
  useHook.getChanges = getChanges;
140
+ useHook.clearChange = clearChange;
119
141
  useHook.clearChanges = clearChanges;
120
142
  return useHook;
121
143
  };exports.createBucket=createBucket;//# sourceMappingURL=index.js.map
package/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["import { useEffect, useId, useMemo, useState } from \"react\"\n\nexport type BucketOptions = {\n store?: \"memory\" | \"session\" | \"local\" | \"url\"\n}\n\nexport const createBucket = <IT extends { [key: string]: any }>(initial: IT, option?: BucketOptions) => {\n const hooks = new Map<string, Function>()\n let data = new Map<any, any>()\n let changes = new Map<string, boolean>()\n\n let _option: BucketOptions = {\n store: \"memory\",\n ...option,\n }\n\n for (let key in initial) {\n let value = initial[key]\n data.set(key, value)\n changes.set(key, true)\n }\n\n const handleStorage = (isLoaded = true) => {\n if (typeof window !== 'undefined') {\n let url = new URL(window.location.href)\n if (_option.store === 'session' || _option.store === 'local') {\n let storage = _option.store === \"session\" ? sessionStorage : localStorage\n for (let key in initial) {\n let has = storage.getItem(key) !== null\n if (isLoaded || !has) {\n data.has(key) ? storage.setItem(key, data.get(key)) : storage.removeItem(key)\n } else if (has) {\n data.set(key, storage.getItem(key))\n }\n }\n } else if (_option.store === \"url\") {\n for (let key in initial) {\n let has = url.searchParams.has(key)\n if (isLoaded || !has) {\n data.has(key) ? url.searchParams.set(key, data.get(key)) : url.searchParams.delete(key)\n } else if (has) {\n data.set(key, url.searchParams.get(key))\n }\n }\n window.history.replaceState(null, '', url.toString())\n }\n }\n }\n\n handleStorage(false)\n\n let dispatch = () => {\n hooks.forEach(d => {\n try { d() } catch (error) { }\n })\n handleStorage()\n }\n\n const set = <T extends keyof IT>(key: T, value: IT[T]) => {\n if (!(key in initial)) throw new Error(`(${key as string}) Invalid key provided in the set function. Please verify the structure of the initial state data.`)\n data.set(key, value)\n changes.set(key as string, true)\n dispatch()\n }\n\n const get = <T extends keyof IT>(key: T): IT[T] => data.get(key)\n const _delete = <T extends keyof IT>(key: T) => {\n data.delete(key)\n changes.set(key as string, true)\n dispatch()\n }\n\n const clear = () => {\n for (let key in initial) {\n data.delete(key)\n changes.set(key, true)\n }\n dispatch()\n }\n\n const getState = () => {\n let d: any = {}\n for (let key in initial) {\n d[key] = data.get(key)\n }\n return d as IT\n }\n\n const setState = (state: Partial<IT>) => {\n for (let key in state) {\n if (!(key in initial)) throw new Error(`(${key}) Invalid key provided in the setState function. Please verify the structure of the initial state data.`)\n data.set(key, state[key] as any)\n changes.set(key, true)\n }\n dispatch()\n }\n const isChange = <T extends keyof IT>(key: T) => changes.get(key as string)\n const getChanges = () => Array.from(changes.keys()).filter((key: string) => changes.get(key as string))\n const clearChanges = () => Array.from(changes.keys()).forEach((key: string) => changes.set(key, false))\n\n const useHook = () => {\n const id = useId()\n const [d, setUp] = useState(0)\n\n useEffect(() => {\n hooks.set(id, () => setUp(Math.random()))\n return () => {\n hooks.delete(id)\n }\n }, [])\n\n const state = useMemo(() => getState(), [d])\n\n return {\n set,\n get,\n delete: _delete,\n clear,\n getState: () => state,\n setState,\n isChange,\n getChanges,\n clearChanges,\n }\n }\n\n useHook.set = set\n useHook.get = get\n useHook.delete = _delete\n useHook.clear = clear\n useHook.getState = getState\n useHook.setState = setState\n useHook.isChange = isChange\n useHook.getChanges = getChanges\n useHook.clearChanges = clearChanges\n\n return useHook\n}"],"names":["useId","useState","useEffect","useMemo"],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["\nimport { useEffect, useId, useMemo, useState } from \"react\"\n\nexport type BucketOptions = {\n store?: \"memory\" | \"session\" | \"local\" | \"url\",\n onChange?: (key: string, value: any, type: \"set\" | \"delete\") => void\n}\n\nexport const createBucket = <IT extends { [key: string]: any }>(initial: IT, option?: BucketOptions) => {\n const hooks = new Map<string, Function>()\n let data = new Map<any, any>()\n let changes = new Map<string, boolean>()\n\n let _option: BucketOptions = {\n store: \"memory\",\n ...option,\n }\n\n let dispatch = () => {\n hooks.forEach(d => {\n try { d() } catch (error) { }\n })\n }\n\n const set = <T extends keyof IT>(key: T, value: IT[T]) => {\n if (!(key in initial)) throw new Error(`(${key as string}) Invalid key provided in the set function. Please verify the structure of the initial state data.`)\n\n if (typeof window !== 'undefined' && (_option.store === 'session' || _option.store === 'local')) {\n let storage = _option.store === \"session\" ? sessionStorage : localStorage\n storage.setItem(key as string, JSON.stringify(value))\n } else if (typeof window !== 'undefined' && _option.store === 'url') {\n let url = new URL(window.location.href)\n url.searchParams.set(key as string, encodeURIComponent(JSON.stringify(value)))\n window.history.replaceState({}, '', url.toString())\n } else {\n data.set(key, value)\n }\n if (_option.onChange) {\n _option.onChange(key as string, value, 'set')\n }\n changes.set(key as string, true)\n dispatch()\n }\n\n const get = <T extends keyof IT>(key: T): IT[T] => {\n if (!(key in initial)) throw new Error(`(${key as string}) Invalid key provided in the get function. Please verify the structure of the initial state data.`)\n if (typeof window !== 'undefined' && (_option.store === 'session' || _option.store === 'local')) {\n let storage = _option.store === \"session\" ? sessionStorage : localStorage\n let storedValue = storage.getItem(key as string)!\n try {\n return JSON.parse(storedValue)\n } catch {\n return storedValue as any\n }\n } else if (typeof window !== 'undefined' && _option.store === 'url') {\n let url = new URL(window.location.href)\n let storedValue = url.searchParams.get(key as string)!\n try {\n return JSON.parse(decodeURIComponent(storedValue))\n } catch {\n return storedValue as any\n }\n }\n return data.get(key)\n }\n\n const del = <T extends keyof IT>(key: T) => {\n if (!(key in initial)) throw new Error(`(${key as string}) Invalid key provided in the delete function. Please verify the structure of the initial state data.`)\n set(key, undefined as any)\n if (_option.onChange) {\n _option.onChange(key as string, undefined, 'delete')\n }\n changes.set(key as string, true)\n dispatch()\n }\n\n const has = <T extends keyof IT>(key: T) => {\n const value = get(key)\n return value !== undefined && value !== null\n }\n\n const isInitialed = () => {\n return has(Object.keys(initial).shift() as keyof IT)\n }\n\n const clear = () => {\n for (let key in initial) {\n del(key as keyof IT)\n changes.set(key, true)\n }\n dispatch()\n }\n\n const getState = () => {\n let d: any = {}\n for (let key in initial) {\n d[key] = get(key)\n }\n return d as IT\n }\n\n const setState = (state: Partial<IT>) => {\n for (let key in state) {\n if (!(key in initial)) throw new Error(`(${key}) Invalid key provided in the setState function. Please verify the structure of the initial state data.`)\n set(key as keyof IT, state[key] as IT[typeof key])\n changes.set(key, true)\n }\n dispatch()\n }\n\n const isChange = <T extends keyof IT>(key: T) => changes.get(key as string) || false\n const clearChange = <T extends keyof IT>(key: T) => changes.set(key as string, false)\n const getChanges = () => Array.from(changes.keys()).filter((key: string) => clearChange(key))\n const clearChanges = () => Array.from(changes.keys()).forEach((key: string) => changes.set(key, false))\n\n if (!isInitialed()) {\n for (let key in initial) {\n set(key as keyof IT, initial[key])\n }\n }\n\n const useHook = () => {\n const id = useId()\n const [d, setUp] = useState(0)\n\n useEffect(() => {\n hooks.set(id, () => setUp(Math.random()))\n return () => {\n hooks.delete(id)\n }\n }, [])\n\n const state = useMemo(() => getState(), [d])\n\n return {\n set,\n get,\n delete: del,\n clear,\n getState: () => state,\n setState,\n isChange,\n getChanges,\n clearChange,\n clearChanges,\n }\n }\n\n useHook.set = set\n useHook.get = get\n useHook.delete = del\n useHook.clear = clear\n useHook.getState = getState\n useHook.setState = setState\n useHook.isChange = isChange\n useHook.getChanges = getChanges\n useHook.clearChange = clearChange\n useHook.clearChanges = clearChanges\n\n return useHook\n}"],"names":["useId","useState","useEffect","useMemo"],"mappings":"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"}
package/index.mjs CHANGED
@@ -3,41 +3,6 @@ import {useId,useState,useEffect,useMemo}from'react';const createBucket = (initi
3
3
  let data = new Map();
4
4
  let changes = new Map();
5
5
  let _option = Object.assign({ store: "memory" }, option);
6
- for (let key in initial) {
7
- let value = initial[key];
8
- data.set(key, value);
9
- changes.set(key, true);
10
- }
11
- const handleStorage = (isLoaded = true) => {
12
- if (typeof window !== 'undefined') {
13
- let url = new URL(window.location.href);
14
- if (_option.store === 'session' || _option.store === 'local') {
15
- let storage = _option.store === "session" ? sessionStorage : localStorage;
16
- for (let key in initial) {
17
- let has = storage.getItem(key) !== null;
18
- if (isLoaded || !has) {
19
- data.has(key) ? storage.setItem(key, data.get(key)) : storage.removeItem(key);
20
- }
21
- else if (has) {
22
- data.set(key, storage.getItem(key));
23
- }
24
- }
25
- }
26
- else if (_option.store === "url") {
27
- for (let key in initial) {
28
- let has = url.searchParams.has(key);
29
- if (isLoaded || !has) {
30
- data.has(key) ? url.searchParams.set(key, data.get(key)) : url.searchParams.delete(key);
31
- }
32
- else if (has) {
33
- data.set(key, url.searchParams.get(key));
34
- }
35
- }
36
- window.history.replaceState(null, '', url.toString());
37
- }
38
- }
39
- };
40
- handleStorage(false);
41
6
  let dispatch = () => {
42
7
  hooks.forEach(d => {
43
8
  try {
@@ -45,24 +10,73 @@ import {useId,useState,useEffect,useMemo}from'react';const createBucket = (initi
45
10
  }
46
11
  catch (error) { }
47
12
  });
48
- handleStorage();
49
13
  };
50
14
  const set = (key, value) => {
51
15
  if (!(key in initial))
52
16
  throw new Error(`(${key}) Invalid key provided in the set function. Please verify the structure of the initial state data.`);
53
- data.set(key, value);
17
+ if (typeof window !== 'undefined' && (_option.store === 'session' || _option.store === 'local')) {
18
+ let storage = _option.store === "session" ? sessionStorage : localStorage;
19
+ storage.setItem(key, JSON.stringify(value));
20
+ }
21
+ else if (typeof window !== 'undefined' && _option.store === 'url') {
22
+ let url = new URL(window.location.href);
23
+ url.searchParams.set(key, encodeURIComponent(JSON.stringify(value)));
24
+ window.history.replaceState({}, '', url.toString());
25
+ }
26
+ else {
27
+ data.set(key, value);
28
+ }
29
+ if (_option.onChange) {
30
+ _option.onChange(key, value, 'set');
31
+ }
54
32
  changes.set(key, true);
55
33
  dispatch();
56
34
  };
57
- const get = (key) => data.get(key);
58
- const _delete = (key) => {
59
- data.delete(key);
35
+ const get = (key) => {
36
+ if (!(key in initial))
37
+ throw new Error(`(${key}) Invalid key provided in the get function. Please verify the structure of the initial state data.`);
38
+ if (typeof window !== 'undefined' && (_option.store === 'session' || _option.store === 'local')) {
39
+ let storage = _option.store === "session" ? sessionStorage : localStorage;
40
+ let storedValue = storage.getItem(key);
41
+ try {
42
+ return JSON.parse(storedValue);
43
+ }
44
+ catch (_a) {
45
+ return storedValue;
46
+ }
47
+ }
48
+ else if (typeof window !== 'undefined' && _option.store === 'url') {
49
+ let url = new URL(window.location.href);
50
+ let storedValue = url.searchParams.get(key);
51
+ try {
52
+ return JSON.parse(decodeURIComponent(storedValue));
53
+ }
54
+ catch (_b) {
55
+ return storedValue;
56
+ }
57
+ }
58
+ return data.get(key);
59
+ };
60
+ const del = (key) => {
61
+ if (!(key in initial))
62
+ throw new Error(`(${key}) Invalid key provided in the delete function. Please verify the structure of the initial state data.`);
63
+ set(key, undefined);
64
+ if (_option.onChange) {
65
+ _option.onChange(key, undefined, 'delete');
66
+ }
60
67
  changes.set(key, true);
61
68
  dispatch();
62
69
  };
70
+ const has = (key) => {
71
+ const value = get(key);
72
+ return value !== undefined && value !== null;
73
+ };
74
+ const isInitialed = () => {
75
+ return has(Object.keys(initial).shift());
76
+ };
63
77
  const clear = () => {
64
78
  for (let key in initial) {
65
- data.delete(key);
79
+ del(key);
66
80
  changes.set(key, true);
67
81
  }
68
82
  dispatch();
@@ -70,7 +84,7 @@ import {useId,useState,useEffect,useMemo}from'react';const createBucket = (initi
70
84
  const getState = () => {
71
85
  let d = {};
72
86
  for (let key in initial) {
73
- d[key] = data.get(key);
87
+ d[key] = get(key);
74
88
  }
75
89
  return d;
76
90
  };
@@ -78,14 +92,20 @@ import {useId,useState,useEffect,useMemo}from'react';const createBucket = (initi
78
92
  for (let key in state) {
79
93
  if (!(key in initial))
80
94
  throw new Error(`(${key}) Invalid key provided in the setState function. Please verify the structure of the initial state data.`);
81
- data.set(key, state[key]);
95
+ set(key, state[key]);
82
96
  changes.set(key, true);
83
97
  }
84
98
  dispatch();
85
99
  };
86
- const isChange = (key) => changes.get(key);
87
- const getChanges = () => Array.from(changes.keys()).filter((key) => changes.get(key));
100
+ const isChange = (key) => changes.get(key) || false;
101
+ const clearChange = (key) => changes.set(key, false);
102
+ const getChanges = () => Array.from(changes.keys()).filter((key) => clearChange(key));
88
103
  const clearChanges = () => Array.from(changes.keys()).forEach((key) => changes.set(key, false));
104
+ if (!isInitialed()) {
105
+ for (let key in initial) {
106
+ set(key, initial[key]);
107
+ }
108
+ }
89
109
  const useHook = () => {
90
110
  const id = useId();
91
111
  const [d, setUp] = useState(0);
@@ -99,23 +119,25 @@ import {useId,useState,useEffect,useMemo}from'react';const createBucket = (initi
99
119
  return {
100
120
  set,
101
121
  get,
102
- delete: _delete,
122
+ delete: del,
103
123
  clear,
104
124
  getState: () => state,
105
125
  setState,
106
126
  isChange,
107
127
  getChanges,
128
+ clearChange,
108
129
  clearChanges,
109
130
  };
110
131
  };
111
132
  useHook.set = set;
112
133
  useHook.get = get;
113
- useHook.delete = _delete;
134
+ useHook.delete = del;
114
135
  useHook.clear = clear;
115
136
  useHook.getState = getState;
116
137
  useHook.setState = setState;
117
138
  useHook.isChange = isChange;
118
139
  useHook.getChanges = getChanges;
140
+ useHook.clearChange = clearChange;
119
141
  useHook.clearChanges = clearChanges;
120
142
  return useHook;
121
143
  };export{createBucket};//# sourceMappingURL=index.mjs.map
package/index.mjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","sources":["../src/index.ts"],"sourcesContent":["import { useEffect, useId, useMemo, useState } from \"react\"\n\nexport type BucketOptions = {\n store?: \"memory\" | \"session\" | \"local\" | \"url\"\n}\n\nexport const createBucket = <IT extends { [key: string]: any }>(initial: IT, option?: BucketOptions) => {\n const hooks = new Map<string, Function>()\n let data = new Map<any, any>()\n let changes = new Map<string, boolean>()\n\n let _option: BucketOptions = {\n store: \"memory\",\n ...option,\n }\n\n for (let key in initial) {\n let value = initial[key]\n data.set(key, value)\n changes.set(key, true)\n }\n\n const handleStorage = (isLoaded = true) => {\n if (typeof window !== 'undefined') {\n let url = new URL(window.location.href)\n if (_option.store === 'session' || _option.store === 'local') {\n let storage = _option.store === \"session\" ? sessionStorage : localStorage\n for (let key in initial) {\n let has = storage.getItem(key) !== null\n if (isLoaded || !has) {\n data.has(key) ? storage.setItem(key, data.get(key)) : storage.removeItem(key)\n } else if (has) {\n data.set(key, storage.getItem(key))\n }\n }\n } else if (_option.store === \"url\") {\n for (let key in initial) {\n let has = url.searchParams.has(key)\n if (isLoaded || !has) {\n data.has(key) ? url.searchParams.set(key, data.get(key)) : url.searchParams.delete(key)\n } else if (has) {\n data.set(key, url.searchParams.get(key))\n }\n }\n window.history.replaceState(null, '', url.toString())\n }\n }\n }\n\n handleStorage(false)\n\n let dispatch = () => {\n hooks.forEach(d => {\n try { d() } catch (error) { }\n })\n handleStorage()\n }\n\n const set = <T extends keyof IT>(key: T, value: IT[T]) => {\n if (!(key in initial)) throw new Error(`(${key as string}) Invalid key provided in the set function. Please verify the structure of the initial state data.`)\n data.set(key, value)\n changes.set(key as string, true)\n dispatch()\n }\n\n const get = <T extends keyof IT>(key: T): IT[T] => data.get(key)\n const _delete = <T extends keyof IT>(key: T) => {\n data.delete(key)\n changes.set(key as string, true)\n dispatch()\n }\n\n const clear = () => {\n for (let key in initial) {\n data.delete(key)\n changes.set(key, true)\n }\n dispatch()\n }\n\n const getState = () => {\n let d: any = {}\n for (let key in initial) {\n d[key] = data.get(key)\n }\n return d as IT\n }\n\n const setState = (state: Partial<IT>) => {\n for (let key in state) {\n if (!(key in initial)) throw new Error(`(${key}) Invalid key provided in the setState function. Please verify the structure of the initial state data.`)\n data.set(key, state[key] as any)\n changes.set(key, true)\n }\n dispatch()\n }\n const isChange = <T extends keyof IT>(key: T) => changes.get(key as string)\n const getChanges = () => Array.from(changes.keys()).filter((key: string) => changes.get(key as string))\n const clearChanges = () => Array.from(changes.keys()).forEach((key: string) => changes.set(key, false))\n\n const useHook = () => {\n const id = useId()\n const [d, setUp] = useState(0)\n\n useEffect(() => {\n hooks.set(id, () => setUp(Math.random()))\n return () => {\n hooks.delete(id)\n }\n }, [])\n\n const state = useMemo(() => getState(), [d])\n\n return {\n set,\n get,\n delete: _delete,\n clear,\n getState: () => state,\n setState,\n isChange,\n getChanges,\n clearChanges,\n }\n }\n\n useHook.set = set\n useHook.get = get\n useHook.delete = _delete\n useHook.clear = clear\n useHook.getState = getState\n useHook.setState = setState\n useHook.isChange = isChange\n useHook.getChanges = getChanges\n useHook.clearChanges = clearChanges\n\n return useHook\n}"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.mjs","sources":["../src/index.ts"],"sourcesContent":["\nimport { useEffect, useId, useMemo, useState } from \"react\"\n\nexport type BucketOptions = {\n store?: \"memory\" | \"session\" | \"local\" | \"url\",\n onChange?: (key: string, value: any, type: \"set\" | \"delete\") => void\n}\n\nexport const createBucket = <IT extends { [key: string]: any }>(initial: IT, option?: BucketOptions) => {\n const hooks = new Map<string, Function>()\n let data = new Map<any, any>()\n let changes = new Map<string, boolean>()\n\n let _option: BucketOptions = {\n store: \"memory\",\n ...option,\n }\n\n let dispatch = () => {\n hooks.forEach(d => {\n try { d() } catch (error) { }\n })\n }\n\n const set = <T extends keyof IT>(key: T, value: IT[T]) => {\n if (!(key in initial)) throw new Error(`(${key as string}) Invalid key provided in the set function. Please verify the structure of the initial state data.`)\n\n if (typeof window !== 'undefined' && (_option.store === 'session' || _option.store === 'local')) {\n let storage = _option.store === \"session\" ? sessionStorage : localStorage\n storage.setItem(key as string, JSON.stringify(value))\n } else if (typeof window !== 'undefined' && _option.store === 'url') {\n let url = new URL(window.location.href)\n url.searchParams.set(key as string, encodeURIComponent(JSON.stringify(value)))\n window.history.replaceState({}, '', url.toString())\n } else {\n data.set(key, value)\n }\n if (_option.onChange) {\n _option.onChange(key as string, value, 'set')\n }\n changes.set(key as string, true)\n dispatch()\n }\n\n const get = <T extends keyof IT>(key: T): IT[T] => {\n if (!(key in initial)) throw new Error(`(${key as string}) Invalid key provided in the get function. Please verify the structure of the initial state data.`)\n if (typeof window !== 'undefined' && (_option.store === 'session' || _option.store === 'local')) {\n let storage = _option.store === \"session\" ? sessionStorage : localStorage\n let storedValue = storage.getItem(key as string)!\n try {\n return JSON.parse(storedValue)\n } catch {\n return storedValue as any\n }\n } else if (typeof window !== 'undefined' && _option.store === 'url') {\n let url = new URL(window.location.href)\n let storedValue = url.searchParams.get(key as string)!\n try {\n return JSON.parse(decodeURIComponent(storedValue))\n } catch {\n return storedValue as any\n }\n }\n return data.get(key)\n }\n\n const del = <T extends keyof IT>(key: T) => {\n if (!(key in initial)) throw new Error(`(${key as string}) Invalid key provided in the delete function. Please verify the structure of the initial state data.`)\n set(key, undefined as any)\n if (_option.onChange) {\n _option.onChange(key as string, undefined, 'delete')\n }\n changes.set(key as string, true)\n dispatch()\n }\n\n const has = <T extends keyof IT>(key: T) => {\n const value = get(key)\n return value !== undefined && value !== null\n }\n\n const isInitialed = () => {\n return has(Object.keys(initial).shift() as keyof IT)\n }\n\n const clear = () => {\n for (let key in initial) {\n del(key as keyof IT)\n changes.set(key, true)\n }\n dispatch()\n }\n\n const getState = () => {\n let d: any = {}\n for (let key in initial) {\n d[key] = get(key)\n }\n return d as IT\n }\n\n const setState = (state: Partial<IT>) => {\n for (let key in state) {\n if (!(key in initial)) throw new Error(`(${key}) Invalid key provided in the setState function. Please verify the structure of the initial state data.`)\n set(key as keyof IT, state[key] as IT[typeof key])\n changes.set(key, true)\n }\n dispatch()\n }\n\n const isChange = <T extends keyof IT>(key: T) => changes.get(key as string) || false\n const clearChange = <T extends keyof IT>(key: T) => changes.set(key as string, false)\n const getChanges = () => Array.from(changes.keys()).filter((key: string) => clearChange(key))\n const clearChanges = () => Array.from(changes.keys()).forEach((key: string) => changes.set(key, false))\n\n if (!isInitialed()) {\n for (let key in initial) {\n set(key as keyof IT, initial[key])\n }\n }\n\n const useHook = () => {\n const id = useId()\n const [d, setUp] = useState(0)\n\n useEffect(() => {\n hooks.set(id, () => setUp(Math.random()))\n return () => {\n hooks.delete(id)\n }\n }, [])\n\n const state = useMemo(() => getState(), [d])\n\n return {\n set,\n get,\n delete: del,\n clear,\n getState: () => state,\n setState,\n isChange,\n getChanges,\n clearChange,\n clearChanges,\n }\n }\n\n useHook.set = set\n useHook.get = get\n useHook.delete = del\n useHook.clear = clear\n useHook.getState = getState\n useHook.setState = setState\n useHook.isChange = isChange\n useHook.getChanges = getChanges\n useHook.clearChange = clearChange\n useHook.clearChanges = clearChanges\n\n return useHook\n}"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "1.2.2",
2
+ "version": "1.2.4",
3
3
  "name": "react-state-bucket",
4
4
  "author": "Naxrul Ahmed",
5
5
  "license": "MIT",
@@ -15,10 +15,10 @@
15
15
  "devDependencies": {
16
16
  "@types/react": "^19.0.2",
17
17
  "@types/react-dom": "^19.0.2",
18
- "makepack": "^1.7.7",
18
+ "makepack": "^1.7.15",
19
19
  "react": "^19.0.0",
20
20
  "react-dom": "^19.0.0",
21
- "typescript": "^4.4.2"
21
+ "typescript": "^5.9.3"
22
22
  },
23
23
  "keywords": [
24
24
  "react",
package/readme.md CHANGED
@@ -17,6 +17,7 @@ Effortlessly manage React application states with **react-state-bucket**, a ligh
17
17
  - **Custom Hooks**: Seamlessly integrate with React’s functional components.
18
18
  - **TypeScript Support**: Fully typed for a better development experience.
19
19
  - **Lightweight**: Small bundle size with no unnecessary dependencies.
20
+ - **Change Callbacks**: React to every `set` or `delete` via the optional `onChange` hook.
20
21
 
21
22
  ---
22
23
 
@@ -188,9 +189,27 @@ Creates a new bucket for managing the global state.
188
189
 
189
190
  `BucketOptions` allows you to configure how and where the state is stored. It includes:
190
191
 
191
- | Property | Type | Description |
192
- | -------- | ------------------------------------- | ---------------------------------------------- |
193
- | `store` | `'memory', 'session', 'local', 'url'` | Specifies the storage mechanism for the state. |
192
+ | Property | Type | Description |
193
+ | ---------- | ------------------------------------- | ---------------------------------------------------------------------------- |
194
+ | `store` | `'memory', 'session', 'local', 'url'` | Specifies the storage mechanism for the state. |
195
+ | `onChange` | `(key, value, type) => void` | Callback invoked after each `set`/`delete`. `type` is `'set'` or `'delete'`. |
196
+
197
+ #### `onChange` Callback
198
+
199
+ Use `onChange` to observe bucket mutations—for example, to sync analytics or trigger side effects.
200
+
201
+ ```javascript
202
+ const useBucketWithLogger = createBucket(
203
+ { count: 0 },
204
+ {
205
+ onChange: (key, value, type) => {
206
+ console.log(`[bucket] ${type} -> ${key}`, value);
207
+ },
208
+ }
209
+ );
210
+ ```
211
+
212
+ When `set('count', 1)` runs, the callback fires with `(key='count', value=1, type='set')`. Deletions invoke the same hook with `type='delete'` and `value` as `undefined`.
194
213
 
195
214
  ### Returned Functions
196
215