@finsemble/finsemble-ui 7.3.1 → 8.0.0-alpha-3

package/common/redux/createReducer.d.ts

@@ -0,0 +1,128 @@
+import { Action } from "redux";
+import { Draft } from "immer";
+import { Cmd, Loop } from "redux-loop";
+/**
+ * Use `unImmer()` to safely pass objects from reducers to effects.
+ *
+ * @param obj Any object
+ * @returns any
+ */
+export declare const unImmer: (obj: any) => any;
+declare type DeepReadonly<T> = T extends (infer R)[] ? DeepReadonlyArray<R> : T extends Function ? T : T extends object ? DeepReadonlyObject<T> : T;
+interface DeepReadonlyArray<T> extends ReadonlyArray<DeepReadonly<T>> {
+}
+declare type DeepReadonlyObject<T> = {
+    readonly [P in keyof T]: DeepReadonly<T[P]>;
+};
+export interface AnyAction extends Action {
+    [extraProps: string]: any;
+}
+export interface TypedActionCreator<Type extends string> {
+    (...args: any[]): Action<Type>;
+    type: Type;
+}
+declare type MyCaseReducer<S = any, A extends Action = AnyAction> = (state: DeepReadonly<S>, action: A) => DeepReadonly<S> | Loop<DeepReadonly<S>>;
+declare type LoopCaseReducer<S = any, A extends Action = AnyAction> = (state: Draft<S>, action: A, cmd: CMD) => void | S;
+export interface CMD {
+    run: typeof Cmd.run;
+    action: typeof Cmd.action;
+    list: typeof Cmd.list;
+    map: typeof Cmd.map;
+    setTimeout: typeof Cmd.setTimeout;
+    setInterval: typeof Cmd.setInterval;
+    clearTimeout: typeof Cmd.clearTimeout;
+    clearInterval: typeof Cmd.clearInterval;
+}
+export interface ActionReducerMapBuilder<State> {
+    addNoImmerCase<ActionCreator extends TypedActionCreator<string>>(actionCreator: ActionCreator, reducer: MyCaseReducer<State, ReturnType<ActionCreator>>): ActionReducerMapBuilder<State>;
+    addNoImmerCase<Type extends string, A extends Action<Type>>(type: Type, reducer: MyCaseReducer<State, A>): ActionReducerMapBuilder<State>;
+    addCase<ActionCreator extends TypedActionCreator<string>>(actionCreator: ActionCreator, reducer: LoopCaseReducer<State, ReturnType<ActionCreator>>): ActionReducerMapBuilder<State>;
+    addCase<Type extends string, A extends Action<Type>>(type: Type, reducer: LoopCaseReducer<State, A>): ActionReducerMapBuilder<State>;
+}
+declare type CaseReducerValue<State> = {
+    reducer?: MyCaseReducer<State>;
+    loopReducer?: LoopCaseReducer<State>;
+};
+declare type CaseReducers<State> = {
+    [key: string]: CaseReducerValue<State>[];
+};
+/**
+ * A slimmed down version of RTK's builder. See comments below in createReducer() for more information.
+ */
+export declare function executeReducerBuilderCallback<S>(builderCallback: (builder: ActionReducerMapBuilder<S>) => void): CaseReducers<S>;
+export declare type Reducer<S = any, A extends Action = AnyAction> = (state: S | undefined, action: A) => S;
+export declare type CreateReducerHook = <S>(previousState: S, nextState: S, action: AnyAction) => void;
+/**
+ * This requires that redux-loops middleware has been installed in the store.
+ *
+ * This is a forked version of the custom createReducer() from React-Toolkit (RTK).
+ * This version adds support for redux-loops by passing a `cmd` as an optional third parameter in the reducer call.
+ * That `cmd` is a proxy for redux-loop's "Cmd" and can be use in the same way.
+ *
+ * Unlike RTK's createReducer, this version does allow you to add multiple reducer cases for the same dispatch. Be
+ * careful not to make assumptions about which reducer will run first! This is best used when there are no dependencies.
+ *
+ * The following RTK functionality has been removed: addMatcher(), addDefaultCase(), "Map Object" notation
+ *
+ * Direct state mutation via return values is still supported but a special builder function `addNoImmerCase`
+ * is better suited for those situations because it enforces read only state. This case will also not send a redux-loop
+ * cmd as a third parameter because you can use redux-loops the normal way.
+ *
+ * Example: Using redux-loop
+ * ```
+ * builder.addCase(myAction, (state, action: PayloadAction<ClientAdded>, cmd) => {
+ * 		state.blah = action.payload.blah; // Do normal reducer stuff
+ *
+ * 		// Create a loop, see redux-loop documentation
+ * 		cmd.run(getLinkerState, {
+ * 			args : [windowName],
+ * 			successActionCreator : actions.initializeWindow
+ * 		})
+ * })
+ * ```
+ *
+ * Use `Cmd.getState`, `Cmd.dispatch` or `Cmd.none` by importing them from redux-loop. There aren't equivalents for cmd because
+ * redux-loop uses the "unique symbol" type which cannot be copied (or so it seems).
+ *
+ * Example: Using Cmd.getState
+ * ```
+ * cmd.run(getLinkerState, { args: [Cmd.getState] })
+ * ```
+ *
+ * Example: using addNoImmerCase
+ * ```
+ * builder.addNoImmerCase(myAction, (state, action: PayloadAction<ClientAdded>) => {
+ * 		const newState = produce(state, (draft) => {
+ * 			draft.blah=action.payload.blah; // Good!
+ * 			state.blah=action.payload.blah; // Typescript error, you can't modify state!
+ * 		});
+ *
+ * 		// Use redux-loop the old fashioned way
+ * 		return loop(
+ * 			newState,
+ * 			Cmd.action(actions.dummy("blah"))
+ * 		)
+ * });
+ *
+ * ```
+ *
+ * Internals:
+ *
+ * Like RTK, the reducer cases are reduced to single nextState and returned to redux. To extract the loops
+ * we use the CmdProxy to temporarily store the loop commands. They are compiled into a single `Cmd.list`
+ * at the very end of the dispatch cycle. So in effect, redux is always receiving a loop from this reducer
+ * rather than a state. This will therefore not work correctly if redux-loops middleware is not installed!
+ */
+export declare function createReducer<S>(initialState: S, mapOrBuilderCallback: (builder: ActionReducerMapBuilder<S>) => void, hook?: CreateReducerHook): Reducer<S>;
+/**
+ * Use this instead of console.log() when inside of reducers. Since addCase uses
+ * immer under the covers, console.log will print out the entire immer proxy object which is ugly
+ */
+export declare const log: (label: any, value: any) => void;
+/**
+ * Predicate function for comparing an actionCreator to a raw action
+ * Example: `addMatcherCase(is(action.joinChannels), ...`
+ */
+export declare const is: (actionCreator: any) => (action: AnyAction) => boolean;
+export {};
+//# sourceMappingURL=createReducer.d.ts.map

package/common/redux/createReducer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createReducer.d.ts","sourceRoot":"","sources":["../../../../src/common/redux/createReducer.ts"],"names":[],"mappings":"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"}

package/common/redux/createReducer.js

@@ -0,0 +1,298 @@
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { produce, isDraft, isDraftable } from "immer";
+import { loop, Cmd, isLoop, } from "redux-loop";
+/**
+ * Use `unImmer()` to safely pass objects from reducers to effects.
+ *
+ * @param obj Any object
+ * @returns any
+ */
+export const unImmer = (obj) => JSON.parse(JSON.stringify(obj));
+const formatRunCmd = (cmd) => {
+    let obj = {
+        RUN: cmd.func.name,
+    };
+    if (cmd.args && cmd.args.length > 0) {
+        // nested if args contains an object
+        if (cmd.args.some((arg) => typeof arg === "object"))
+            obj.args = cmd.args;
+        // string, for quick reading
+        else
+            obj.args = cmd.args.join(" ");
+    }
+    if (cmd.successActionCreator)
+        obj.successActionCreator = cmd.successActionCreator.name;
+    if (cmd.failActionCreator)
+        obj.successActionCreator = cmd.failActionCreator.name;
+    return obj;
+};
+const formatActionCmd = (cmd) => {
+    const _a = cmd.actionToDispatch, { type } = _a, members = __rest(_a, ["type"]);
+    return Object.assign({ ACTION: type }, members);
+};
+/**
+ * Formats redux-loop cmds for very quick human perusal in redux-devtools.
+ */
+const formatCmdForDisplay = (cmd) => {
+    switch (cmd.type) {
+        case "RUN": {
+            return formatRunCmd(cmd);
+        }
+        case "LIST":
+            return Object.assign(Object.assign({}, cmd), { cmds: cmd.cmds.map(formatCmdForDisplay) });
+        case "MAP":
+            return Object.assign(Object.assign({}, cmd), { tagger: cmd.tagger.name, nestedCmd: formatCmdForDisplay(cmd.nestedCmd) });
+        case "ACTION":
+            return formatActionCmd(cmd);
+        case "NONE":
+        default:
+            return cmd;
+    }
+};
+/**
+ * Intercepts calls to `cmd()` within reducers. The cmds are remembered and then
+ * consolidated into a singl Cmd.List() at the end of the reducer process (bottom of this file).
+ */
+class CmdProxy {
+    constructor() {
+        this.commands = [];
+    }
+    run(fn, args) {
+        let runCmd = Cmd.run(fn, args);
+        this.commands.push(runCmd);
+        return runCmd;
+    }
+    action(action) {
+        let runCmd = Cmd.action(action);
+        this.commands.push(runCmd);
+        return runCmd;
+    }
+    list(cmds, options) {
+        let runCmd = Cmd.list(cmds, options);
+        this.commands.push(runCmd);
+        return runCmd;
+    }
+    map(cmd, tagger, args) {
+        let runCmd = Cmd.map(cmd, tagger, args);
+        this.commands.push(runCmd);
+        return runCmd;
+    }
+    clearTimeout(timerId) {
+        let runCmd = Cmd.clearTimeout(timerId);
+        this.commands.push(runCmd);
+        return runCmd;
+    }
+    clearInterval(timerId) {
+        let runCmd = Cmd.clearInterval(timerId);
+        this.commands.push(runCmd);
+        return runCmd;
+    }
+    setTimeout(cmd, delayMs, options) {
+        let runCmd = Cmd.setTimeout(cmd, delayMs, options);
+        this.commands.push(runCmd);
+        return runCmd;
+    }
+    setInterval(cmd, delayMs, options) {
+        let runCmd = Cmd.setInterval(cmd, delayMs, options);
+        this.commands.push(runCmd);
+        return runCmd;
+    }
+}
+/**
+ * A slimmed down version of RTK's builder. See comments below in createReducer() for more information.
+ */
+export function executeReducerBuilderCallback(builderCallback) {
+    // Unlike RTK, supports multiple reducer cases per action, but does not support isMatcher or default cases
+    const actionsMap = {};
+    const builder = {
+        addNoImmerCase(typeOrActionCreator, reducer) {
+            var _a;
+            const type = typeof typeOrActionCreator === "string" ? typeOrActionCreator : typeOrActionCreator.type;
+            actionsMap[type] = ((_a = actionsMap[type]) !== null && _a !== void 0 ? _a : []).concat({ reducer });
+            return builder;
+        },
+        addCase(typeOrActionCreator, loopReducer) {
+            var _a;
+            const type = typeof typeOrActionCreator === "string" ? typeOrActionCreator : typeOrActionCreator.type;
+            actionsMap[type] = ((_a = actionsMap[type]) !== null && _a !== void 0 ? _a : []).concat({ loopReducer });
+            return builder;
+        },
+    };
+    builderCallback(builder);
+    return actionsMap;
+}
+/**
+ * Runs the loop reducer on a non-draftable reducer (one that returns a value rather than using immer). This
+ * has a little extra logic to protect against the reducer being used improperly.
+ */
+const reduceNonDraftable = (loopReducer, state, action, cmdProxy) => {
+    const resultState = loopReducer(state, action, cmdProxy);
+    // case reducers that aren't working on immer drafts should always return a value
+    // The sole exception is the first pass through (indicated by previousState being null)
+    if (typeof resultState === "undefined") {
+        if (state !== null) {
+            throw Error("A case reducer on a non-draftable value must not return undefined");
+        }
+        return state;
+    }
+    return resultState;
+};
+/**
+ * This is what makes the redux-toolkit style createReducer function compatible with redux-loops.
+ * It runs the reducer (loopReducer from redux-loop) but instead of running each individual Cmd, it compiles
+ * them into an array so that they can all be run in one swoop.
+ */
+const runLoopReducer = (caseReducers, state, action, hook) => {
+    let commands = [];
+    const reducedState = caseReducers.reduce((previousState, caseReducer) => {
+        const cmdProxy = new CmdProxy();
+        let nextState = previousState;
+        if (caseReducer) {
+            const { reducer, loopReducer } = caseReducer;
+            if (reducer) {
+                nextState = reducer(previousState, action);
+                if (isLoop(nextState)) {
+                    commands = commands.concat([nextState[1]]);
+                    nextState = nextState[0];
+                }
+            }
+            else if (loopReducer) {
+                if (isDraft(previousState)) {
+                    // If it's already a draft, we must already be inside a `createNextState` call,
+                    // likely because this is being wrapped in `createReducer`, `createSlice`, or nested
+                    // inside an existing draft. It's safe to just pass the draft to the mutator. We
+                    // run loopReducer here only to get the commands
+                    loopReducer(previousState, action, cmdProxy);
+                    commands = commands.concat(cmdProxy.commands);
+                }
+                else if (!isDraftable(previousState)) {
+                    // If state is not draftable (ex: a primitive, such as 0), we want to directly
+                    // return the caseReducer func and not wrap it with produce.
+                    nextState = reduceNonDraftable(loopReducer, previousState, action, cmdProxy);
+                }
+                else {
+                    nextState = produce(previousState, (draft) => {
+                        loopReducer(draft, action, cmdProxy);
+                        commands = commands.concat(cmdProxy.commands);
+                    });
+                }
+            }
+        }
+        hook === null || hook === void 0 ? void 0 : hook(previousState, nextState, action);
+        return nextState;
+    }, state);
+    return { reducedState, commands };
+};
+/**
+ * This requires that redux-loops middleware has been installed in the store.
+ *
+ * This is a forked version of the custom createReducer() from React-Toolkit (RTK).
+ * This version adds support for redux-loops by passing a `cmd` as an optional third parameter in the reducer call.
+ * That `cmd` is a proxy for redux-loop's "Cmd" and can be use in the same way.
+ *
+ * Unlike RTK's createReducer, this version does allow you to add multiple reducer cases for the same dispatch. Be
+ * careful not to make assumptions about which reducer will run first! This is best used when there are no dependencies.
+ *
+ * The following RTK functionality has been removed: addMatcher(), addDefaultCase(), "Map Object" notation
+ *
+ * Direct state mutation via return values is still supported but a special builder function `addNoImmerCase`
+ * is better suited for those situations because it enforces read only state. This case will also not send a redux-loop
+ * cmd as a third parameter because you can use redux-loops the normal way.
+ *
+ * Example: Using redux-loop
+ * ```
+ * builder.addCase(myAction, (state, action: PayloadAction<ClientAdded>, cmd) => {
+ * 		state.blah = action.payload.blah; // Do normal reducer stuff
+ *
+ * 		// Create a loop, see redux-loop documentation
+ * 		cmd.run(getLinkerState, {
+ * 			args : [windowName],
+ * 			successActionCreator : actions.initializeWindow
+ * 		})
+ * })
+ * ```
+ *
+ * Use `Cmd.getState`, `Cmd.dispatch` or `Cmd.none` by importing them from redux-loop. There aren't equivalents for cmd because
+ * redux-loop uses the "unique symbol" type which cannot be copied (or so it seems).
+ *
+ * Example: Using Cmd.getState
+ * ```
+ * cmd.run(getLinkerState, { args: [Cmd.getState] })
+ * ```
+ *
+ * Example: using addNoImmerCase
+ * ```
+ * builder.addNoImmerCase(myAction, (state, action: PayloadAction<ClientAdded>) => {
+ * 		const newState = produce(state, (draft) => {
+ * 			draft.blah=action.payload.blah; // Good!
+ * 			state.blah=action.payload.blah; // Typescript error, you can't modify state!
+ * 		});
+ *
+ * 		// Use redux-loop the old fashioned way
+ * 		return loop(
+ * 			newState,
+ * 			Cmd.action(actions.dummy("blah"))
+ * 		)
+ * });
+ *
+ * ```
+ *
+ * Internals:
+ *
+ * Like RTK, the reducer cases are reduced to single nextState and returned to redux. To extract the loops
+ * we use the CmdProxy to temporarily store the loop commands. They are compiled into a single `Cmd.list`
+ * at the very end of the dispatch cycle. So in effect, redux is always receiving a loop from this reducer
+ * rather than a state. This will therefore not work correctly if redux-loops middleware is not installed!
+ */
+export function createReducer(initialState, mapOrBuilderCallback, hook) {
+    const actionsMap = executeReducerBuilderCallback(mapOrBuilderCallback);
+    return function (state = initialState, action) {
+        const caseReducers = actionsMap[action.type];
+        if (!(caseReducers === null || caseReducers === void 0 ? void 0 : caseReducers.length)) {
+            return state;
+        }
+        const { reducedState, commands } = runLoopReducer(caseReducers, state, action, hook);
+        const cmds = Cmd.list(commands);
+        /**
+         * If any cmds are to be run, inject them into state so that we can see them using devtools.
+         * We jump through some hoops here in order to format the result for the quickest observation.
+         * The convoluted code is worth the result.
+         */
+        // Scrub out the old @@cmds
+        const _a = reducedState, { "@@cmds": oldCmds } = _a, scrubbedState = __rest(_a, ["@@cmds"]);
+        const oneOrNoneCommandState = cmds.cmds.length == 1
+            ? Object.assign(Object.assign({}, scrubbedState), { "@@cmds": formatCmdForDisplay(cmds.cmds[0]) }) : scrubbedState;
+        // Add in the new @@cmds, if any
+        const loopEnhancedState = cmds.cmds.length > 1
+            ? Object.assign(Object.assign({}, scrubbedState), { "@@cmds": cmds.cmds.map((cmd) => formatCmdForDisplay(cmd)) }) : oneOrNoneCommandState;
+        // Hard casting to avoid the store thinking it is a `Loop<S> | S` type
+        // This is okay because redux-loop middleware extracts the loops inside of redux
+        return loop(loopEnhancedState, cmds);
+    };
+}
+/**
+ * Use this instead of console.log() when inside of reducers. Since addCase uses
+ * immer under the covers, console.log will print out the entire immer proxy object which is ugly
+ */
+export const log = (label, value) => {
+    if (value)
+        console.log(label, JSON.parse(JSON.stringify(value)));
+    else
+        console.log(label, value);
+};
+/**
+ * Predicate function for comparing an actionCreator to a raw action
+ * Example: `addMatcherCase(is(action.joinChannels), ...`
+ */
+export const is = (actionCreator) => (action) => action.type === actionCreator.type;
+//# sourceMappingURL=createReducer.js.map

package/common/redux/createReducer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createReducer.js","sourceRoot":"","sources":["../../../../src/common/redux/createReducer.ts"],"names":[],"mappings":"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"}

package/common/redux/index.d.ts

@@ -0,0 +1,3 @@
+export { remoteReduxClientEnhancer, remoteReduxServerEnhancer } from "./remoteReduxEnhancer";
+export { createReducer, CreateReducerHook } from "./createReducer";
+//# sourceMappingURL=index.d.ts.map

package/common/redux/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/common/redux/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAC7F,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/common/redux/index.js

@@ -0,0 +1,3 @@
+export { remoteReduxClientEnhancer, remoteReduxServerEnhancer } from "./remoteReduxEnhancer";
+export { createReducer } from "./createReducer";
+//# sourceMappingURL=index.js.map

package/common/redux/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/common/redux/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAC7F,OAAO,EAAE,aAAa,EAAqB,MAAM,iBAAiB,CAAC"}

package/common/redux/remoteReduxEnhancer.d.ts

@@ -0,0 +1,29 @@
+import { StoreEnhancer, Action } from "@reduxjs/toolkit";
+import { RemoteReduxServerAddress } from "./types";
+declare type PromiseDispatch = <T extends Action>(promise: Promise<T>) => Promise<T>;
+/**
+ * Creates the client side of a remote redux.
+ * Exposes a store enhancer that will synchronize a copy of a slice of state.
+ * Initially used in the Interop Service and Linker UI.
+ *
+ * @param param.server fixed string "address"
+ * @param param.slice slice of state to observe and synchronize (i.e. rootState[slice])
+ */
+export declare const remoteReduxClientEnhancer: ({ server, slice }: {
+    server: RemoteReduxServerAddress;
+    slice: string;
+}) => StoreEnhancer<{
+    dispatch: PromiseDispatch;
+}, {}>;
+/**
+ * Creates the server side of a remote redux. This enhancer should be added before DevTools.instrument().
+ *
+ * @param param.server string The router channel that this server should listen on
+ */
+export declare const remoteReduxServerEnhancer: ({ server }: {
+    server: RemoteReduxServerAddress;
+}) => StoreEnhancer<{
+    dispatch: PromiseDispatch;
+}, {}>;
+export {};
+//# sourceMappingURL=remoteReduxEnhancer.d.ts.map

package/common/redux/remoteReduxEnhancer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteReduxEnhancer.d.ts","sourceRoot":"","sources":["../../../../src/common/redux/remoteReduxEnhancer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,aAAa,EAAE,MAAM,EAAoC,MAAM,kBAAkB,CAAC;AAIpG,OAAO,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAMnD,aAAK,eAAe,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAE7E;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB;YAAiC,wBAAwB;WAAS,MAAM;;cAExD,eAAe;MAyDpE,CAAC;AA6IF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;YAA0B,wBAAwB;;cAClC,eAAe;MAyDpE,CAAC"}