2022-03-25 12:31:21 +00:00
|
|
|
import * as plugins from './smartstate.plugins.js';
|
|
|
|
import { StatePart } from './smartstate.classes.statepart.js';
|
2020-11-29 23:51:05 +00:00
|
|
|
|
2023-10-03 11:19:38 +00:00
|
|
|
export type TInitMode = 'soft' | 'mandatory' | 'force' | 'persistent';
|
|
|
|
|
2020-11-29 23:51:05 +00:00
|
|
|
/**
|
|
|
|
* Smartstate takes care of providing state
|
|
|
|
*/
|
|
|
|
export class Smartstate<StatePartNameType> {
|
2022-01-24 05:39:36 +00:00
|
|
|
public statePartMap: { [key: string]: StatePart<StatePartNameType, any> } = {};
|
2020-11-29 23:51:05 +00:00
|
|
|
|
|
|
|
constructor() {}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Allows getting and initializing a new statepart
|
|
|
|
* initMode === 'soft' it will allow existing stateparts
|
|
|
|
* initMode === 'mandatory' will fail if there is an exiting statepart
|
|
|
|
* initMode === 'force' will overwrite any existing statepart
|
|
|
|
* @param statePartNameArg
|
|
|
|
* @param initialArg
|
|
|
|
* @param initMode
|
|
|
|
*/
|
|
|
|
public getStatePart<PayloadType>(
|
|
|
|
statePartNameArg: string & StatePartNameType,
|
|
|
|
initialArg?: PayloadType,
|
2023-10-03 11:19:38 +00:00
|
|
|
initMode?: TInitMode
|
2020-11-29 23:51:05 +00:00
|
|
|
): StatePart<StatePartNameType, PayloadType> {
|
|
|
|
if (this.statePartMap[statePartNameArg as any]) {
|
|
|
|
if (initialArg && (!initMode || initMode !== 'soft')) {
|
|
|
|
throw new Error(
|
|
|
|
`${statePartNameArg} already exists, yet you try to set an initial state again`
|
|
|
|
);
|
|
|
|
}
|
|
|
|
return this.statePartMap[statePartNameArg] as StatePart<StatePartNameType, PayloadType>;
|
|
|
|
} else {
|
|
|
|
if (!initialArg) {
|
|
|
|
throw new Error(
|
|
|
|
`${statePartNameArg} does not yet exist, yet you don't provide an initial state`
|
|
|
|
);
|
|
|
|
}
|
2023-10-03 11:19:38 +00:00
|
|
|
return this.createStatePart<PayloadType>(statePartNameArg, initialArg, initMode);
|
2020-11-29 23:51:05 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* creates a statepart
|
|
|
|
* @param statePartName
|
|
|
|
* @param initialPayloadArg
|
|
|
|
*/
|
|
|
|
private createStatePart<PayloadType>(
|
|
|
|
statePartName: StatePartNameType,
|
2023-10-03 11:19:38 +00:00
|
|
|
initialPayloadArg: PayloadType,
|
|
|
|
initMode?: TInitMode
|
2020-11-29 23:51:05 +00:00
|
|
|
): StatePart<StatePartNameType, PayloadType> {
|
2023-10-03 11:19:38 +00:00
|
|
|
const newState = new StatePart<StatePartNameType, PayloadType>(
|
|
|
|
statePartName,
|
|
|
|
initMode === 'persistent' ? {
|
|
|
|
dbName: 'smartstate',
|
|
|
|
storeName: statePartName as any,
|
|
|
|
} : null
|
|
|
|
);
|
2020-11-29 23:51:05 +00:00
|
|
|
newState.setState(initialPayloadArg);
|
|
|
|
this.statePartMap[statePartName as any] = newState;
|
|
|
|
return newState;
|
|
|
|
}
|
|
|
|
}
|