feat(stateprocess): add managed state processes with lifecycle controls, scheduled actions, and disposal safety

ts/smartstate.classes.smartstate.ts

@@ -49,7 +49,11 @@ export class Smartstate<StatePartNameType extends string> {
             const pending = [...this.pendingNotifications];
             this.pendingNotifications.clear();
             for (const sp of pending) {
-              await sp.notifyChange();
+              try {
+                await sp.notifyChange();
+              } catch (err) {
+                console.error(`Error flushing notification for state part:`, err);
+              }
             }
           }
         } finally {
@@ -69,6 +73,21 @@ export class Smartstate<StatePartNameType extends string> {
     return computed(sources, computeFn);
   }
 
+  /**
+   * disposes all state parts and clears internal state
+   */
+  public dispose(): void {
+    for (const key of Object.keys(this.statePartMap)) {
+      const part = this.statePartMap[key as StatePartNameType];
+      if (part) {
+        part.dispose();
+      }
+    }
+    this.statePartMap = {} as any;
+    this.pendingStatePartCreation.clear();
+    this.pendingNotifications.clear();
+  }
+
   /**
    * Allows getting and initializing a new statepart
    */
@@ -107,7 +126,7 @@ export class Smartstate<StatePartNameType extends string> {
       }
     }
 
-    const creationPromise = this.createStatePart<PayloadType>(statePartNameArg, initialArg, initMode);
+    const creationPromise = this.createStatePart<PayloadType>(statePartNameArg, initialArg!, initMode);
     this.pendingStatePartCreation.set(statePartNameArg, creationPromise);
 
     try {
@@ -133,7 +152,7 @@ export class Smartstate<StatePartNameType extends string> {
             dbName: 'smartstate',
             storeName: statePartName,
           }
-        : null
+        : undefined
     );
     newState.smartstateRef = this;
     await newState.init();