smartstate/ts/smartstate.classes.smartstate.ts

67 lines
2.1 KiB
TypeScript
Raw Normal View History

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;
}
}