@jbrowse/mobx-state-tree 5.5.0 → 5.6.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (99) hide show
  1. package/README.md +18 -0
  2. package/dist/core/action.d.ts +1 -1
  3. package/dist/core/action.js +228 -0
  4. package/dist/core/action.js.map +1 -1
  5. package/dist/core/actionContext.js +42 -0
  6. package/dist/core/actionContext.js.map +1 -1
  7. package/dist/core/flow.d.ts +1 -1
  8. package/dist/core/flow.js +180 -0
  9. package/dist/core/flow.js.map +1 -1
  10. package/dist/core/json-patch.js +133 -0
  11. package/dist/core/json-patch.js.map +1 -1
  12. package/dist/core/mst-operations.js +885 -0
  13. package/dist/core/mst-operations.js.map +1 -1
  14. package/dist/core/node/BaseNode.js +152 -0
  15. package/dist/core/node/BaseNode.js.map +1 -1
  16. package/dist/core/node/Hook.js +15 -0
  17. package/dist/core/node/Hook.js.map +1 -1
  18. package/dist/core/node/create-node.js +41 -0
  19. package/dist/core/node/create-node.js.map +1 -1
  20. package/dist/core/node/identifier-cache.js +115 -0
  21. package/dist/core/node/identifier-cache.js.map +1 -1
  22. package/dist/core/node/livelinessChecking.js +38 -0
  23. package/dist/core/node/livelinessChecking.js.map +1 -1
  24. package/dist/core/node/node-utils.js +165 -0
  25. package/dist/core/node/node-utils.js.map +1 -1
  26. package/dist/core/node/object-node.js +545 -0
  27. package/dist/core/node/object-node.js.map +1 -1
  28. package/dist/core/node/scalar-node.js +89 -0
  29. package/dist/core/node/scalar-node.js.map +1 -1
  30. package/dist/core/process.d.ts +1 -1
  31. package/dist/core/process.js +39 -0
  32. package/dist/core/process.js.map +1 -1
  33. package/dist/core/type/type-checker.js +154 -0
  34. package/dist/core/type/type-checker.js.map +1 -1
  35. package/dist/core/type/type.d.ts +1 -1
  36. package/dist/core/type/type.js +251 -0
  37. package/dist/core/type/type.js.map +1 -1
  38. package/dist/index.js +85 -0
  39. package/dist/index.js.map +1 -1
  40. package/dist/internal.d.ts +1 -0
  41. package/dist/internal.js +60 -0
  42. package/dist/internal.js.map +1 -1
  43. package/dist/middlewares/create-action-tracking-middleware.js +81 -0
  44. package/dist/middlewares/create-action-tracking-middleware.js.map +1 -1
  45. package/dist/middlewares/createActionTrackingMiddleware2.js +133 -0
  46. package/dist/middlewares/createActionTrackingMiddleware2.js.map +1 -1
  47. package/dist/middlewares/on-action.js +215 -0
  48. package/dist/middlewares/on-action.js.map +1 -1
  49. package/dist/mobx-state-tree.js +83 -6750
  50. package/dist/mobx-state-tree.module.js +83 -6672
  51. package/dist/types/complex-types/array.d.ts +1 -1
  52. package/dist/types/complex-types/array.js +352 -0
  53. package/dist/types/complex-types/array.js.map +1 -1
  54. package/dist/types/complex-types/map.d.ts +1 -1
  55. package/dist/types/complex-types/map.js +361 -0
  56. package/dist/types/complex-types/map.js.map +1 -1
  57. package/dist/types/complex-types/model.js +477 -0
  58. package/dist/types/complex-types/model.js.map +1 -1
  59. package/dist/types/index.d.ts +2 -1
  60. package/dist/types/index.js +38 -0
  61. package/dist/types/index.js.map +1 -1
  62. package/dist/types/primitives.js +182 -0
  63. package/dist/types/primitives.js.map +1 -1
  64. package/dist/types/utility-types/custom.js +110 -0
  65. package/dist/types/utility-types/custom.js.map +1 -1
  66. package/dist/types/utility-types/enumeration.js +34 -0
  67. package/dist/types/utility-types/enumeration.js.map +1 -1
  68. package/dist/types/utility-types/frozen.js +97 -0
  69. package/dist/types/utility-types/frozen.js.map +1 -1
  70. package/dist/types/utility-types/identifier.js +129 -0
  71. package/dist/types/utility-types/identifier.js.map +1 -1
  72. package/dist/types/utility-types/late.js +109 -0
  73. package/dist/types/utility-types/late.js.map +1 -1
  74. package/dist/types/utility-types/lazy.js +76 -0
  75. package/dist/types/utility-types/lazy.js.map +1 -1
  76. package/dist/types/utility-types/literal.js +63 -0
  77. package/dist/types/utility-types/literal.js.map +1 -1
  78. package/dist/types/utility-types/maybe.js +30 -0
  79. package/dist/types/utility-types/maybe.js.map +1 -1
  80. package/dist/types/utility-types/optional.js +140 -0
  81. package/dist/types/utility-types/optional.js.map +1 -1
  82. package/dist/types/utility-types/reference.d.ts +2 -2
  83. package/dist/types/utility-types/reference.js +392 -0
  84. package/dist/types/utility-types/reference.js.map +1 -1
  85. package/dist/types/utility-types/refinement.js +85 -0
  86. package/dist/types/utility-types/refinement.js.map +1 -1
  87. package/dist/types/utility-types/resilient.d.ts +18 -0
  88. package/dist/types/utility-types/resilient.js +120 -0
  89. package/dist/types/utility-types/resilient.js.map +1 -0
  90. package/dist/types/utility-types/snapshotProcessor.js +161 -0
  91. package/dist/types/utility-types/snapshotProcessor.js.map +1 -1
  92. package/dist/types/utility-types/union.d.ts +1 -0
  93. package/dist/types/utility-types/union.js +245 -0
  94. package/dist/types/utility-types/union.js.map +1 -1
  95. package/dist/utils.js +483 -0
  96. package/dist/utils.js.map +1 -1
  97. package/package.json +26 -24
  98. package/changelog.md +0 -677
  99. package/dist/mobx-state-tree.umd.js +0 -6756
package/README.md CHANGED
@@ -13,3 +13,21 @@ Fork of mobx-state-tree v5.4.2 for use in jbrowse
13
13
  - remove unused dependencies
14
14
  - updated tslint to eslint and typescript-eslint
15
15
  - attempted to make it a dual CJS/'pure ESM' package but did not work quite yet, using main (CJS) and module (ESM-ish) fields for now since dual build causes trouble with both being imported in vite
16
+ - added `types.resilient` - wraps a type so that instantiation errors are caught
17
+ and a fallback type is used instead of crashing the entire state tree. This is
18
+ useful for arrays or maps that may contain unknown or invalid entries (e.g.
19
+ plugin types that are not installed). It takes a primary type, a fallback type,
20
+ and a `createFallbackSnapshot` callback that receives the error and original
21
+ snapshot. Note: `isValidSnapshot` always returns success for resilient types,
22
+ meaning any value is considered a valid snapshot. Validation is deferred to
23
+ instantiation time, where failures are caught and routed to the fallback
24
+ - dramatically shorter error messages with large type trees
25
+
26
+ ## Publishing
27
+
28
+ [Trusted publishing](https://docs.npmjs.com/about-trusted-publishing) via GitHub
29
+ Actions.
30
+
31
+ ```bash
32
+ pnpm version patch # or minor/major
33
+ ```
@@ -49,7 +49,7 @@ export declare function getParentActionContext(parentContext: IMiddlewareEvent |
49
49
  * @internal
50
50
  * @hidden
51
51
  */
52
- export declare function createActionInvoker<T extends FunctionWithFlag>(target: IAnyStateTreeNode, name: string, fn: T): () => any;
52
+ export declare function createActionInvoker<T extends FunctionWithFlag>(target: IAnyStateTreeNode, name: string, fn: T): (...args: any[]) => any;
53
53
  /**
54
54
  * Middleware can be used to intercept any action is invoked on the subtree where it is attached.
55
55
  * If a tree is protected (by default), this means that any mutation of the tree will pass through your middleware.
@@ -0,0 +1,228 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.getCurrentActionContext = getCurrentActionContext;
4
+ exports.getNextActionId = getNextActionId;
5
+ exports.runWithActionContext = runWithActionContext;
6
+ exports.getParentActionContext = getParentActionContext;
7
+ exports.createActionInvoker = createActionInvoker;
8
+ exports.addMiddleware = addMiddleware;
9
+ exports.decorate = decorate;
10
+ const mobx_1 = require("mobx");
11
+ const internal_ts_1 = require("../internal.js");
12
+ let nextActionId = 1;
13
+ let currentActionContext;
14
+ /**
15
+ * @internal
16
+ * @hidden
17
+ */
18
+ function getCurrentActionContext() {
19
+ return currentActionContext;
20
+ }
21
+ /**
22
+ * @internal
23
+ * @hidden
24
+ */
25
+ function getNextActionId() {
26
+ return nextActionId++;
27
+ }
28
+ // TODO: optimize away entire action context if there is no middleware in tree?
29
+ /**
30
+ * @internal
31
+ * @hidden
32
+ */
33
+ function runWithActionContext(context, fn) {
34
+ const node = (0, internal_ts_1.getStateTreeNode)(context.context);
35
+ if (context.type === "action") {
36
+ node.assertAlive({
37
+ actionContext: context
38
+ });
39
+ }
40
+ const baseIsRunningAction = node._isRunningAction;
41
+ node._isRunningAction = true;
42
+ const previousContext = currentActionContext;
43
+ currentActionContext = context;
44
+ try {
45
+ return runMiddleWares(node, context, fn);
46
+ }
47
+ finally {
48
+ currentActionContext = previousContext;
49
+ node._isRunningAction = baseIsRunningAction;
50
+ }
51
+ }
52
+ /**
53
+ * @internal
54
+ * @hidden
55
+ */
56
+ function getParentActionContext(parentContext) {
57
+ if (!parentContext) {
58
+ return undefined;
59
+ }
60
+ if (parentContext.type === "action") {
61
+ return parentContext;
62
+ }
63
+ return parentContext.parentActionEvent;
64
+ }
65
+ /**
66
+ * @internal
67
+ * @hidden
68
+ */
69
+ function createActionInvoker(target, name, fn) {
70
+ const res = function (...args) {
71
+ const id = getNextActionId();
72
+ const parentContext = currentActionContext;
73
+ const parentActionContext = getParentActionContext(parentContext);
74
+ return runWithActionContext({
75
+ type: "action",
76
+ name,
77
+ id,
78
+ args,
79
+ context: target,
80
+ tree: (0, internal_ts_1.getRoot)(target),
81
+ rootId: parentContext ? parentContext.rootId : id,
82
+ parentId: parentContext ? parentContext.id : 0,
83
+ allParentIds: parentContext
84
+ ? [...parentContext.allParentIds, parentContext.id]
85
+ : [],
86
+ parentEvent: parentContext,
87
+ parentActionEvent: parentActionContext
88
+ }, fn);
89
+ };
90
+ res._isMSTAction = true;
91
+ res._isFlowAction = fn._isFlowAction;
92
+ return res;
93
+ }
94
+ /**
95
+ * Middleware can be used to intercept any action is invoked on the subtree where it is attached.
96
+ * If a tree is protected (by default), this means that any mutation of the tree will pass through your middleware.
97
+ *
98
+ * For more details, see the [middleware docs](concepts/middleware.md)
99
+ *
100
+ * @param target Node to apply the middleware to.
101
+ * @param middleware Middleware to apply.
102
+ * @returns A callable function to dispose the middleware.
103
+ */
104
+ function addMiddleware(target, handler, includeHooks = true) {
105
+ const node = (0, internal_ts_1.getStateTreeNode)(target);
106
+ if ((0, internal_ts_1.devMode)()) {
107
+ if (!node.isProtectionEnabled) {
108
+ (0, internal_ts_1.warnError)("It is recommended to protect the state tree before attaching action middleware, as otherwise it cannot be guaranteed that all changes are passed through middleware. See `protect`");
109
+ }
110
+ }
111
+ return node.addMiddleWare(handler, includeHooks);
112
+ }
113
+ /**
114
+ * Binds middleware to a specific action.
115
+ *
116
+ * Example:
117
+ * ```ts
118
+ * type.actions(self => {
119
+ * function takeA____() {
120
+ * self.toilet.donate()
121
+ * self.wipe()
122
+ * self.wipe()
123
+ * self.toilet.flush()
124
+ * }
125
+ * return {
126
+ * takeA____: decorate(atomic, takeA____)
127
+ * }
128
+ * })
129
+ * ```
130
+ *
131
+ * @param handler
132
+ * @param fn
133
+ * @param includeHooks
134
+ * @returns The original function
135
+ */
136
+ function decorate(handler, fn, includeHooks = true) {
137
+ const middleware = { handler, includeHooks };
138
+ fn.$mst_middleware = fn.$mst_middleware || [];
139
+ fn.$mst_middleware.push(middleware);
140
+ return fn;
141
+ }
142
+ class CollectedMiddlewares {
143
+ arrayIndex = 0;
144
+ inArrayIndex = 0;
145
+ middlewares = [];
146
+ constructor(node, fn) {
147
+ // we just push middleware arrays into an array of arrays to avoid making copies
148
+ if (fn.$mst_middleware) {
149
+ this.middlewares.push(fn.$mst_middleware);
150
+ }
151
+ let n = node;
152
+ // Find all middlewares. Optimization: cache this?
153
+ while (n) {
154
+ if (n.middlewares) {
155
+ this.middlewares.push(n.middlewares);
156
+ }
157
+ n = n.parent;
158
+ }
159
+ }
160
+ get isEmpty() {
161
+ return this.middlewares.length <= 0;
162
+ }
163
+ getNextMiddleware() {
164
+ const array = this.middlewares[this.arrayIndex];
165
+ if (!array) {
166
+ return undefined;
167
+ }
168
+ const item = array[this.inArrayIndex++];
169
+ if (!item) {
170
+ this.arrayIndex++;
171
+ this.inArrayIndex = 0;
172
+ return this.getNextMiddleware();
173
+ }
174
+ return item;
175
+ }
176
+ }
177
+ function runMiddleWares(node, baseCall, originalFn) {
178
+ const middlewares = new CollectedMiddlewares(node, originalFn);
179
+ // Short circuit
180
+ if (middlewares.isEmpty) {
181
+ return (0, mobx_1.action)(originalFn)(...baseCall.args);
182
+ }
183
+ let result = null;
184
+ function runNextMiddleware(call) {
185
+ const middleware = middlewares.getNextMiddleware();
186
+ const handler = middleware && middleware.handler;
187
+ if (!handler) {
188
+ return (0, mobx_1.action)(originalFn)(...call.args);
189
+ }
190
+ // skip hooks if asked to
191
+ if (!middleware.includeHooks && internal_ts_1.Hook[call.name]) {
192
+ return runNextMiddleware(call);
193
+ }
194
+ let nextInvoked = false;
195
+ function next(call2, callback) {
196
+ nextInvoked = true;
197
+ // the result can contain
198
+ // - the non manipulated return value from an action
199
+ // - the non manipulated abort value
200
+ // - one of the above but manipulated through the callback function
201
+ result = runNextMiddleware(call2);
202
+ if (callback) {
203
+ result = callback(result);
204
+ }
205
+ }
206
+ let abortInvoked = false;
207
+ function abort(value) {
208
+ abortInvoked = true;
209
+ // overwrite the result
210
+ // can be manipulated through middlewares earlier in the queue using the callback fn
211
+ result = value;
212
+ }
213
+ handler(call, next, abort);
214
+ if ((0, internal_ts_1.devMode)()) {
215
+ if (!nextInvoked && !abortInvoked) {
216
+ const node2 = (0, internal_ts_1.getStateTreeNode)(call.tree);
217
+ throw (0, internal_ts_1.fail)(`Neither the next() nor the abort() callback within the middleware ${handler.name} for the action: "${call.name}" on the node: ${node2.type.name} was invoked.`);
218
+ }
219
+ else if (nextInvoked && abortInvoked) {
220
+ const node2 = (0, internal_ts_1.getStateTreeNode)(call.tree);
221
+ throw (0, internal_ts_1.fail)(`The next() and abort() callback within the middleware ${handler.name} for the action: "${call.name}" on the node: ${node2.type.name} were invoked.`);
222
+ }
223
+ }
224
+ return result;
225
+ }
226
+ return runNextMiddleware(baseCall);
227
+ }
228
+ //# sourceMappingURL=action.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"action.js","sourceRoot":"","sources":["../../src/core/action.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"action.js","sourceRoot":"","sources":["../../src/core/action.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,42 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.getRunningActionContext = getRunningActionContext;
4
+ exports.isActionContextChildOf = isActionContextChildOf;
5
+ exports.isActionContextThisOrChildOf = isActionContextThisOrChildOf;
6
+ const action_ts_1 = require("./action.js");
7
+ /**
8
+ * Returns the currently executing MST action context, or undefined if none.
9
+ */
10
+ function getRunningActionContext() {
11
+ let current = (0, action_ts_1.getCurrentActionContext)();
12
+ while (current && current.type !== "action") {
13
+ current = current.parentActionEvent;
14
+ }
15
+ return current;
16
+ }
17
+ function _isActionContextThisOrChildOf(actionContext, sameOrParent, includeSame) {
18
+ const parentId = typeof sameOrParent === "number" ? sameOrParent : sameOrParent.id;
19
+ let current = includeSame
20
+ ? actionContext
21
+ : actionContext.parentActionEvent;
22
+ while (current) {
23
+ if (current.id === parentId) {
24
+ return true;
25
+ }
26
+ current = current.parentActionEvent;
27
+ }
28
+ return false;
29
+ }
30
+ /**
31
+ * Returns if the given action context is a parent of this action context.
32
+ */
33
+ function isActionContextChildOf(actionContext, parent) {
34
+ return _isActionContextThisOrChildOf(actionContext, parent, false);
35
+ }
36
+ /**
37
+ * Returns if the given action context is this or a parent of this action context.
38
+ */
39
+ function isActionContextThisOrChildOf(actionContext, parentOrThis) {
40
+ return _isActionContextThisOrChildOf(actionContext, parentOrThis, true);
41
+ }
42
+ //# sourceMappingURL=actionContext.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"actionContext.js","sourceRoot":"","sources":["../../src/core/actionContext.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAqBrD;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,IAAI,OAAO,GAAG,uBAAuB,EAAE,CAAA;IACvC,OAAO,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAA;IACrC,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,SAAS,6BAA6B,CACpC,aAA6B,EAC7B,YAAwD,EACxD,WAAoB;IAEpB,MAAM,QAAQ,GACZ,OAAO,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAA;IAEnE,IAAI,OAAO,GAAkD,WAAW;QACtE,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,aAAa,CAAC,iBAAiB,CAAA;IACnC,OAAO,OAAO,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAA;QACb,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAA;IACrC,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,aAA6B,EAC7B,MAAkD;IAElD,OAAO,6BAA6B,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC,CAAA;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAC1C,aAA6B,EAC7B,YAAwD;IAExD,OAAO,6BAA6B,CAAC,aAAa,EAAE,YAAY,EAAE,IAAI,CAAC,CAAA;AACzE,CAAC"}
1
+ {"version":3,"file":"actionContext.js","sourceRoot":"","sources":["../../src/core/actionContext.ts"],"names":[],"mappings":";;AAyBA,0DAMC;AAyBD,wDAKC;AAKD,oEAKC;AAtED,2CAAqD;AAqBrD;;GAEG;AACH,SAAgB,uBAAuB;IACrC,IAAI,OAAO,GAAG,IAAA,mCAAuB,GAAE,CAAA;IACvC,OAAO,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAA;IACrC,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,SAAS,6BAA6B,CACpC,aAA6B,EAC7B,YAAwD,EACxD,WAAoB;IAEpB,MAAM,QAAQ,GACZ,OAAO,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAA;IAEnE,IAAI,OAAO,GAAkD,WAAW;QACtE,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,aAAa,CAAC,iBAAiB,CAAA;IACnC,OAAO,OAAO,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAA;QACb,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAA;IACrC,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CACpC,aAA6B,EAC7B,MAAkD;IAElD,OAAO,6BAA6B,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC,CAAA;AACpE,CAAC;AAED;;GAEG;AACH,SAAgB,4BAA4B,CAC1C,aAA6B,EAC7B,YAAwD;IAExD,OAAO,6BAA6B,CAAC,aAAa,EAAE,YAAY,EAAE,IAAI,CAAC,CAAA;AACzE,CAAC"}
@@ -66,4 +66,4 @@ export declare function toGenerator<R>(p: Promise<R>): Generator<Promise<R>, R,
66
66
  * @internal
67
67
  * @hidden
68
68
  */
69
- export declare function createFlowSpawner(name: string, generator: FunctionWithFlag): (this: any) => Promise<unknown>;
69
+ export declare function createFlowSpawner(name: string, generator: FunctionWithFlag): (this: any, ...flowArgs: any[]) => Promise<unknown>;
@@ -0,0 +1,180 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.flow = flow;
4
+ exports.castFlowReturn = castFlowReturn;
5
+ exports.toGeneratorFunction = toGeneratorFunction;
6
+ exports.toGenerator = toGenerator;
7
+ exports.createFlowSpawner = createFlowSpawner;
8
+ const utils_ts_1 = require("../utils.js");
9
+ const action_ts_1 = require("./action.js");
10
+ /**
11
+ * See [asynchronous actions](concepts/async-actions.md).
12
+ *
13
+ * @returns The flow as a promise.
14
+ */
15
+ function flow(generator) {
16
+ return createFlowSpawner(generator.name, generator);
17
+ }
18
+ /**
19
+ * @deprecated Not needed since TS3.6.
20
+ * Used for TypeScript to make flows that return a promise return the actual promise result.
21
+ *
22
+ * @param val
23
+ * @returns
24
+ */
25
+ function castFlowReturn(val) {
26
+ return val;
27
+ }
28
+ /**
29
+ * @experimental
30
+ * experimental api - might change on minor/patch releases
31
+ *
32
+ * Convert a promise-returning function to a generator-returning one.
33
+ * This is intended to allow for usage of `yield*` in async actions to
34
+ * retain the promise return type.
35
+ *
36
+ * Example:
37
+ * ```ts
38
+ * function getDataAsync(input: string): Promise<number> { ... }
39
+ * const getDataGen = toGeneratorFunction(getDataAsync);
40
+ *
41
+ * const someModel.actions(self => ({
42
+ * someAction: flow(function*() {
43
+ * // value is typed as number
44
+ * const value = yield* getDataGen("input value");
45
+ * ...
46
+ * })
47
+ * }))
48
+ * ```
49
+ */
50
+ function toGeneratorFunction(p) {
51
+ return function* (...args) {
52
+ return (yield p(...args));
53
+ };
54
+ }
55
+ /**
56
+ * @experimental
57
+ * experimental api - might change on minor/patch releases
58
+ *
59
+ * Convert a promise to a generator yielding that promise
60
+ * This is intended to allow for usage of `yield*` in async actions to
61
+ * retain the promise return type.
62
+ *
63
+ * Example:
64
+ * ```ts
65
+ * function getDataAsync(input: string): Promise<number> { ... }
66
+ *
67
+ * const someModel.actions(self => ({
68
+ * someAction: flow(function*() {
69
+ * // value is typed as number
70
+ * const value = yield* toGenerator(getDataAsync("input value"));
71
+ * ...
72
+ * })
73
+ * }))
74
+ * ```
75
+ */
76
+ function* toGenerator(p) {
77
+ return (yield p);
78
+ }
79
+ /**
80
+ * @internal
81
+ * @hidden
82
+ */
83
+ function createFlowSpawner(name, generator) {
84
+ const spawner = function flowSpawner(...flowArgs) {
85
+ // Implementation based on https://github.com/tj/co/blob/master/index.js
86
+ const runId = (0, action_ts_1.getNextActionId)();
87
+ const parentContext = (0, action_ts_1.getCurrentActionContext)();
88
+ if (!parentContext) {
89
+ throw (0, utils_ts_1.fail)("a mst flow must always have a parent context");
90
+ }
91
+ const parentActionContext = (0, action_ts_1.getParentActionContext)(parentContext);
92
+ if (!parentActionContext) {
93
+ throw (0, utils_ts_1.fail)("a mst flow must always have a parent action context");
94
+ }
95
+ const contextBase = {
96
+ name,
97
+ id: runId,
98
+ tree: parentContext.tree,
99
+ context: parentContext.context,
100
+ parentId: parentContext.id,
101
+ allParentIds: [...parentContext.allParentIds, parentContext.id],
102
+ rootId: parentContext.rootId,
103
+ parentEvent: parentContext,
104
+ parentActionEvent: parentActionContext
105
+ };
106
+ function wrap(fn, type, arg) {
107
+ fn.$mst_middleware = spawner.$mst_middleware; // pick up any middleware attached to the flow
108
+ return (0, action_ts_1.runWithActionContext)({
109
+ ...contextBase,
110
+ type,
111
+ args: [arg]
112
+ }, fn);
113
+ }
114
+ return new Promise(function (resolve, reject) {
115
+ let gen;
116
+ const init = function asyncActionInit(...initArgs) {
117
+ gen = generator(...initArgs);
118
+ onFulfilled(undefined); // kick off the flow
119
+ };
120
+ init.$mst_middleware = spawner.$mst_middleware;
121
+ (0, action_ts_1.runWithActionContext)({
122
+ ...contextBase,
123
+ type: "flow_spawn",
124
+ args: flowArgs
125
+ }, init);
126
+ function onFulfilled(res) {
127
+ let ret;
128
+ try {
129
+ // prettier-ignore
130
+ const cancelError = wrap((_r) => { ret = gen.next(_r); }, "flow_resume", res);
131
+ if (cancelError instanceof Error) {
132
+ ret = gen.throw(cancelError);
133
+ }
134
+ }
135
+ catch (e) {
136
+ // prettier-ignore
137
+ (0, utils_ts_1.setImmediateWithFallback)(() => {
138
+ wrap((_r) => { reject(e); }, "flow_throw", e);
139
+ });
140
+ return;
141
+ }
142
+ next(ret);
143
+ return;
144
+ }
145
+ function onRejected(err) {
146
+ let ret;
147
+ try {
148
+ // prettier-ignore
149
+ wrap((_r) => { ret = gen.throw(_r); }, "flow_resume_error", err); // or yieldError?
150
+ }
151
+ catch (e) {
152
+ // prettier-ignore
153
+ (0, utils_ts_1.setImmediateWithFallback)(() => {
154
+ wrap((_r) => { reject(e); }, "flow_throw", e);
155
+ });
156
+ return;
157
+ }
158
+ next(ret);
159
+ }
160
+ function next(ret) {
161
+ if (ret.done) {
162
+ // prettier-ignore
163
+ (0, utils_ts_1.setImmediateWithFallback)(() => {
164
+ wrap((r) => { resolve(r); }, "flow_return", ret.value);
165
+ });
166
+ return;
167
+ }
168
+ // TODO: support more type of values? See https://github.com/tj/co/blob/249bbdc72da24ae44076afd716349d2089b31c4c/index.js#L100
169
+ if (!ret.value || typeof ret.value.then !== "function") {
170
+ // istanbul ignore next
171
+ throw (0, utils_ts_1.fail)("Only promises can be yielded to `async`, got: " + ret);
172
+ }
173
+ return ret.value.then(onFulfilled, onRejected);
174
+ }
175
+ });
176
+ };
177
+ spawner._isFlowAction = true;
178
+ return spawner;
179
+ }
180
+ //# sourceMappingURL=flow.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"flow.js","sourceRoot":"","sources":["../../src/core/flow.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"flow.js","sourceRoot":"","sources":["../../src/core/flow.ts"],"names":[],"mappings":"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"}