septor-store 0.0.6 → 1.0.1

package/README.md

@@ -1,4 +1,5 @@
 # Vue 3 + TypeScript + Vite
+
 <p align="center">
   <img src="https://github.com/ssengedonazil/septor-store-testing/blob/POM/assets/septor-store.png?raw=true" alt="Septor Logo" width="180" />
 </p>
@@ -22,6 +23,7 @@ septor-store is a structured and scalable state management solution built on top
 | Post + Submit Support                     | Easily manage POST data and track responses  |
 | Flexible Callbacks                        | Use custom callbacks on state update         |
 | Loading & Error States                    | Built-in support for loading/errors          |
+| clean all the state against the store id
 
 - Automatic API Call Queue Management Prevents multiple simultaneous calls to the same endpoint by tracking ongoing requests.
 - Session Storage Caching Support Optionally caches API responses in sessionStorage for faster retrieval and offline resilience.
@@ -266,7 +268,44 @@ const handleSubmit = async () => {
 </script>
 
 ```
+
+### Usage **EXAMPLE 3**  Remove all the data stored(cleare)🤭
+
+```
+Note: StateClean this activates the  opearation
+
+const usePomStore = pomPinia('myCustomStoreId',null,{StateClean:true});
+  const pomStore = usePomStore();
+
+
+const handleSubmit = async () => {
+  const config = {
+    StateStore: 'packageList',
+    reqs: {
+      url: '/api/packagelist', //call your  endpoint
+      method: 'post',
+      data: user.value,
+    }, 
+    reload: true,
+  }
+
+  const res = await pomStore.stateGenaratorApi(config, (oldData) => {
+    console.log('Previous post result if any:', oldData)
+  })
+  result.value = res
+}
+
+  pomStore.WipeStates(stateId) // remove just  a paticular id (eg packageList)
+  pomStore.WipeStates() // remove all the states
+
+```
+
+🤝 Contributing and Feedback
+We welcome all contributions and feedback to improve septor-store!
+If you encounter any bugs, have suggestions, or want to contribute,
+ please open an issue or submit a pull request:
+👉 Report Issues or Suggestions : <https://github.com/ssengedonazil/septor-store-testing>
+
 If you find this package useful, consider supporting me:
 
 [![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/ssengendonazil)
-

package/dist/index.cjs

@@ -159,8 +159,10 @@ function getBearerToken() {
 }
 
 // src/StoreManager/pomStateManagement.js
-function createPomStore(piniaStore = "7286204094", callBack = null) {
+function createPomStore(piniaStore = "7286204094", callBack = null, ds = { StateClean: 0 }) {
   const storeId = "POM" + piniaStore;
+  const StateNameUsedSoferList = "septor-store-collection";
+  ;
   const piniaData = (0, import_pinia.defineStore)(storeId, {
     state: () => {
       const StateObjectsContainer = {
@@ -228,21 +230,36 @@ function createPomStore(piniaStore = "7286204094", callBack = null) {
             sessionStorage.removeItem(dataResponseName);
           }
           if (mStore == null ? void 0 : mStore.mUse) {
-            const thisData = JSON.parse(
-              JSON.parse(sessionStorage.getItem(dataResponseName) || {})
-            );
+            const thisData = JSON.parse(JSON.parse(sessionStorage.getItem(dataResponseName) || {}));
             return thisData;
           }
         } catch (error) {
         }
         return this[dataResponseName];
       },
-      async stateGenaratorApi(dd = { reload: true, StateStore: "", reqs: {}, time: 0, pagnated: false, mStore: { mUse: 0 } }, fasterDataCollection = null) {
+      WipeStates(storeKeyToRemove = null) {
+        const sptStateData = localStorage.getItem(StateNameUsedSoferList) ?? "{}";
+        let previousState = JSON.parse(sptStateData);
+        if (storeKeyToRemove)
+          delete previousState[storeKeyToRemove];
+        else
+          previousState = {};
+        const regroup = JSON.stringify(previousState);
+        localStorage.setItem(StateNameUsedSoferList, regroup);
+      },
+      async stateGenaratorApi(dd = { reload: true, StateStore: "", reqs: {}, time: 0, pagnated: false, mStore: { mUse: 0, reset: 0 } }, fasterDataCollection = null) {
         this.Loading = true;
         const { reload, StateStore, reqs, time, pagnated, mStore } = dd;
         const callApi = JSON.stringify(reqs);
         const StateVariable = await this.parseData(StateStore, mStore);
         this[StateStore] = StateVariable ?? [];
+        if (ds == null ? void 0 : ds.StateClean) {
+          const sptStateData = localStorage.getItem(StateNameUsedSoferList) ?? "{}";
+          const previousState = JSON.parse(sptStateData);
+          const stateKey = typeof StateStore === "string" ? StateStore : "septore-store-";
+          const regroup = JSON.stringify({ ...previousState, [storeId + "(-_+_-)" + stateKey]: StateStore });
+          localStorage.setItem(StateNameUsedSoferList, regroup);
+        }
         if (this.StateValue[StateStore]) {
           this.StateValue[StateStore] = false;
           this[StateStore] = false;

package/dist/index.d.cts

@@ -118,9 +118,9 @@ function getBearerToken() {
   }
 }
 
-function createPomStore( piniaStore = "7286204094", callBack=null) {
+function createPomStore( piniaStore = "7286204094", callBack=null,ds={StateClean:0}) {
   const storeId = "POM" + piniaStore;
-  const piniaData = defineStore(storeId, {
+  const StateNameUsedSoferList = "septor-store-collection";  const piniaData = defineStore(storeId, {
     state: () => {
       const StateObjectsContainer = {
         CheckQueriesInQue: {},
@@ -137,8 +137,7 @@ function createPomStore( piniaStore = "7286204094", callBack=null) {
         /**
        make data basing on state TagetState this acts as a clusure in ()()  read about it 
        store.stateItems(key1) usage to ge the ge
-       * 
-       */
+       **/
         return (state[TagetState] = state[TagetState]);
       },
     
@@ -173,13 +172,7 @@ function createPomStore( piniaStore = "7286204094", callBack=null) {
         return new Promise((r) => setTimeout(r, timer));
       },
 
-      async CallApiData(
-        StateStore,
-        callApi,
-        dataParams,
-        pagnated ,
-        mStore={}
-      ) {
+      async CallApiData(        StateStore,        callApi,        dataParams,        pagnated ,        mStore={}      ) {
         if (!this.CheckQueriesInQue[callApi]) {
           this.CheckQueriesInQue[callApi] = callApi;
           let [res] = await Promise.all([
@@ -214,23 +207,37 @@ function createPomStore( piniaStore = "7286204094", callBack=null) {
           }
 
           if (mStore?.mUse) {
-            const thisData = JSON.parse(
-              JSON.parse(sessionStorage.getItem(dataResponseName) || {})
-            );
-
+            const thisData = JSON.parse(JSON.parse(sessionStorage.getItem(dataResponseName) || {}));
             return thisData;
           }
         } catch (error) {}
 
         return this[dataResponseName];
       },
-      async stateGenaratorApi(dd = {  reload: true,  StateStore: "",  reqs: {},  time: 0,  pagnated: false,  mStore: { mUse: 0 },},fasterDataCollection=null) {
+       WipeStates(storeKeyToRemove=null){
+         const sptStateData = localStorage.getItem(StateNameUsedSoferList) ?? "{}";
+         let previousState = JSON.parse(sptStateData);
+         if (storeKeyToRemove) 
+             delete previousState[storeKeyToRemove];
+          else 
+           previousState={};
+         
+         const regroup = JSON.stringify(previousState);
+          localStorage.setItem(StateNameUsedSoferList, regroup);
+      },
+      async stateGenaratorApi(dd = {  reload: true,  StateStore: "",  reqs: {},  time: 0,  pagnated: false,  mStore: { mUse: 0,reset:0 },},fasterDataCollection=null) {
         this.Loading = true;
         const { reload, StateStore, reqs, time, pagnated, mStore } = dd;
         const callApi = JSON.stringify(reqs);
         const StateVariable = await this.parseData(StateStore, mStore);
         this[StateStore] = StateVariable ?? [];
-
+        if (ds?.StateClean) {
+          const sptStateData =localStorage.getItem(StateNameUsedSoferList) ?? "{}";
+          const previousState = JSON.parse(sptStateData);
+          const stateKey = typeof StateStore === "string" ? StateStore : "septore-store-";
+          const regroup = JSON.stringify({...previousState,[storeId + "(-_+_-)" + stateKey]: StateStore,});
+          localStorage.setItem(StateNameUsedSoferList, regroup);
+        }
         if (this.StateValue[StateStore]) {
           /**
            *  dynamically lets create the state  store

package/dist/index.d.ts

@@ -118,9 +118,9 @@ function getBearerToken() {
   }
 }
 
-function createPomStore( piniaStore = "7286204094", callBack=null) {
+function createPomStore( piniaStore = "7286204094", callBack=null,ds={StateClean:0}) {
   const storeId = "POM" + piniaStore;
-  const piniaData = defineStore(storeId, {
+  const StateNameUsedSoferList = "septor-store-collection";  const piniaData = defineStore(storeId, {
     state: () => {
       const StateObjectsContainer = {
         CheckQueriesInQue: {},
@@ -137,8 +137,7 @@ function createPomStore( piniaStore = "7286204094", callBack=null) {
         /**
        make data basing on state TagetState this acts as a clusure in ()()  read about it 
        store.stateItems(key1) usage to ge the ge
-       * 
-       */
+       **/
         return (state[TagetState] = state[TagetState]);
       },
     
@@ -173,13 +172,7 @@ function createPomStore( piniaStore = "7286204094", callBack=null) {
         return new Promise((r) => setTimeout(r, timer));
       },
 
-      async CallApiData(
-        StateStore,
-        callApi,
-        dataParams,
-        pagnated ,
-        mStore={}
-      ) {
+      async CallApiData(        StateStore,        callApi,        dataParams,        pagnated ,        mStore={}      ) {
         if (!this.CheckQueriesInQue[callApi]) {
           this.CheckQueriesInQue[callApi] = callApi;
           let [res] = await Promise.all([
@@ -214,23 +207,37 @@ function createPomStore( piniaStore = "7286204094", callBack=null) {
           }
 
           if (mStore?.mUse) {
-            const thisData = JSON.parse(
-              JSON.parse(sessionStorage.getItem(dataResponseName) || {})
-            );
-
+            const thisData = JSON.parse(JSON.parse(sessionStorage.getItem(dataResponseName) || {}));
             return thisData;
           }
         } catch (error) {}
 
         return this[dataResponseName];
       },
-      async stateGenaratorApi(dd = {  reload: true,  StateStore: "",  reqs: {},  time: 0,  pagnated: false,  mStore: { mUse: 0 },},fasterDataCollection=null) {
+       WipeStates(storeKeyToRemove=null){
+         const sptStateData = localStorage.getItem(StateNameUsedSoferList) ?? "{}";
+         let previousState = JSON.parse(sptStateData);
+         if (storeKeyToRemove) 
+             delete previousState[storeKeyToRemove];
+          else 
+           previousState={};
+         
+         const regroup = JSON.stringify(previousState);
+          localStorage.setItem(StateNameUsedSoferList, regroup);
+      },
+      async stateGenaratorApi(dd = {  reload: true,  StateStore: "",  reqs: {},  time: 0,  pagnated: false,  mStore: { mUse: 0,reset:0 },},fasterDataCollection=null) {
         this.Loading = true;
         const { reload, StateStore, reqs, time, pagnated, mStore } = dd;
         const callApi = JSON.stringify(reqs);
         const StateVariable = await this.parseData(StateStore, mStore);
         this[StateStore] = StateVariable ?? [];
-
+        if (ds?.StateClean) {
+          const sptStateData =localStorage.getItem(StateNameUsedSoferList) ?? "{}";
+          const previousState = JSON.parse(sptStateData);
+          const stateKey = typeof StateStore === "string" ? StateStore : "septore-store-";
+          const regroup = JSON.stringify({...previousState,[storeId + "(-_+_-)" + stateKey]: StateStore,});
+          localStorage.setItem(StateNameUsedSoferList, regroup);
+        }
         if (this.StateValue[StateStore]) {
           /**
            *  dynamically lets create the state  store

package/dist/index.js

@@ -119,8 +119,10 @@ function getBearerToken() {
 }
 
 // src/StoreManager/pomStateManagement.js
-function createPomStore(piniaStore = "7286204094", callBack = null) {
+function createPomStore(piniaStore = "7286204094", callBack = null, ds = { StateClean: 0 }) {
   const storeId = "POM" + piniaStore;
+  const StateNameUsedSoferList = "septor-store-collection";
+  ;
   const piniaData = defineStore(storeId, {
     state: () => {
       const StateObjectsContainer = {
@@ -188,21 +190,36 @@ function createPomStore(piniaStore = "7286204094", callBack = null) {
             sessionStorage.removeItem(dataResponseName);
           }
           if (mStore == null ? void 0 : mStore.mUse) {
-            const thisData = JSON.parse(
-              JSON.parse(sessionStorage.getItem(dataResponseName) || {})
-            );
+            const thisData = JSON.parse(JSON.parse(sessionStorage.getItem(dataResponseName) || {}));
             return thisData;
           }
         } catch (error) {
         }
         return this[dataResponseName];
       },
-      async stateGenaratorApi(dd = { reload: true, StateStore: "", reqs: {}, time: 0, pagnated: false, mStore: { mUse: 0 } }, fasterDataCollection = null) {
+      WipeStates(storeKeyToRemove = null) {
+        const sptStateData = localStorage.getItem(StateNameUsedSoferList) ?? "{}";
+        let previousState = JSON.parse(sptStateData);
+        if (storeKeyToRemove)
+          delete previousState[storeKeyToRemove];
+        else
+          previousState = {};
+        const regroup = JSON.stringify(previousState);
+        localStorage.setItem(StateNameUsedSoferList, regroup);
+      },
+      async stateGenaratorApi(dd = { reload: true, StateStore: "", reqs: {}, time: 0, pagnated: false, mStore: { mUse: 0, reset: 0 } }, fasterDataCollection = null) {
         this.Loading = true;
         const { reload, StateStore, reqs, time, pagnated, mStore } = dd;
         const callApi = JSON.stringify(reqs);
         const StateVariable = await this.parseData(StateStore, mStore);
         this[StateStore] = StateVariable ?? [];
+        if (ds == null ? void 0 : ds.StateClean) {
+          const sptStateData = localStorage.getItem(StateNameUsedSoferList) ?? "{}";
+          const previousState = JSON.parse(sptStateData);
+          const stateKey = typeof StateStore === "string" ? StateStore : "septore-store-";
+          const regroup = JSON.stringify({ ...previousState, [storeId + "(-_+_-)" + stateKey]: StateStore });
+          localStorage.setItem(StateNameUsedSoferList, regroup);
+        }
         if (this.StateValue[StateStore]) {
           this.StateValue[StateStore] = false;
           this[StateStore] = false;

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "septor-store",
-  "description": "septor-store is a structured and scalable state management solution built on top of Pinia for Vue 3. It embraces the Plain Old Module (POM) pattern to simplify how developers—junior or senior—write, organize, and scale their application state. Whether you're just starting out or architecting large Vue applications, this tool helps you keep your stores clean, predictable, and easy to indextain.",
+  "description": "A powerful, modular state management solution for Vue 3 applications, built on top of Pinia. Septor Store leverages the Plain Old Module (POM) pattern to provide dynamic store generation, intelligent API request handling, smart caching, and clean separation of concerns—making it ideal for scalable, maintainable, and high-performance frontend development.",
   "private": false,
   "license": "MIT",
-  "version": "0.0.6",
+  "version": "1.0.1",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -25,53 +25,49 @@
     "vue": "^3.5.13"
   },
   "devDependencies": {
-    "@types/axios": "^0.14.4", 
+    "@types/axios": "^0.14.4",
     "tsup": "^8.4.0",
     "typescript": "~5.8.3"
   },
   "keywords": [
-    "pinia",
     "vue",
+    "vue3",
+    "pinia",
+    "pinia store",
+    "vue pinia plugin",
     "state management",
-    "store",
-    "node",
-    "Ajax",
-    "promise", 
-    "vue",
-    "vue3", 
-    "state", 
-    "pom",
-    "pom-pattern",
-    "vue-pinia",
-    "vue-store",
-    "pinia-store",
-    "modular-state",
-    "api-cache",
-    "api-state-manager",
-    "typescript",
-    "vue-typescript",
-    "pinia-plugin",
-    "state-library",
+    "vue state management",
+    "api caching",
+    "vue ssr",
+    "vue spa",
+    "store plugin",
+    "modular state",
+    "dynamic store",
+    "state persistence",
     "frontend tools",
-    "reactive-state",
-    "session-storage",
-    "dynamic-store",
-    "paginated-api",
-    "vue devtools",
-    "session persistence",
+    "api queue",
+    "session storage",
+    "pom pattern",
+    "plain old module",
+    "vue typescript",
+    "typescript",
+    "reactive state",
+    "data fetching",
     "vuex alternative",
-    "smart cache",
-    "Septor Store",
-    "api-queue",
-    "septor-store-vue",
-    "reload-control"
+    "state library",
+    "state sync",
+    "loading state",
+    "vue plugin",
+    "pinia plugin",
+    "septor store",
+    "septor-store-vue"
   ],
   "funding": [
-  {
-    "type": "ko-fi",
-    "url": "https://ko-fi.com/ssengedonazil"
-  }
-],
+    {
+      "type": "ko-fi",
+      "url": "https://ko-fi.com/ssengedonazil"
+    }
+  ],
   "author": "Ssengendo Nazil",
   "repository": {
     "type": "git",