@haneinfo/state-machine 0.0.0-stage → 0.1.1

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 (64) hide show
  1. package/LICENSE +14 -0
  2. package/agent-guide.md +113 -0
  3. package/dist/index.d.ts +11 -0
  4. package/dist/index.d.ts.map +1 -0
  5. package/dist/index.js +35 -0
  6. package/dist/index.js.map +1 -0
  7. package/dist/kind.d.ts +12 -0
  8. package/dist/kind.d.ts.map +1 -0
  9. package/dist/kind.js +48 -0
  10. package/dist/kind.js.map +1 -0
  11. package/dist/mcp-tools.d.ts +58 -0
  12. package/dist/mcp-tools.d.ts.map +1 -0
  13. package/dist/mcp-tools.js +131 -0
  14. package/dist/mcp-tools.js.map +1 -0
  15. package/dist/plugin.d.ts +11 -0
  16. package/dist/plugin.d.ts.map +1 -0
  17. package/dist/plugin.js +72 -0
  18. package/dist/plugin.js.map +1 -0
  19. package/dist/prisma-store.d.ts +8 -0
  20. package/dist/prisma-store.d.ts.map +1 -0
  21. package/dist/prisma-store.js +76 -0
  22. package/dist/prisma-store.js.map +1 -0
  23. package/dist/runtime.service.d.ts +66 -0
  24. package/dist/runtime.service.d.ts.map +1 -0
  25. package/dist/runtime.service.js +292 -0
  26. package/dist/runtime.service.js.map +1 -0
  27. package/dist/semantics.d.ts +8 -0
  28. package/dist/semantics.d.ts.map +1 -0
  29. package/dist/semantics.js +83 -0
  30. package/dist/semantics.js.map +1 -0
  31. package/dist/simulate.d.ts +20 -0
  32. package/dist/simulate.d.ts.map +1 -0
  33. package/dist/simulate.js +46 -0
  34. package/dist/simulate.js.map +1 -0
  35. package/dist/state-machine.controller.d.ts +22 -0
  36. package/dist/state-machine.controller.d.ts.map +1 -0
  37. package/dist/state-machine.controller.js +143 -0
  38. package/dist/state-machine.controller.js.map +1 -0
  39. package/dist/state-machine.module.d.ts +11 -0
  40. package/dist/state-machine.module.d.ts.map +1 -0
  41. package/dist/state-machine.module.js +60 -0
  42. package/dist/state-machine.module.js.map +1 -0
  43. package/dist/store.d.ts +58 -0
  44. package/dist/store.d.ts.map +1 -0
  45. package/dist/store.js +73 -0
  46. package/dist/store.js.map +1 -0
  47. package/dist/testing.d.ts +19 -0
  48. package/dist/testing.d.ts.map +1 -0
  49. package/dist/testing.js +23 -0
  50. package/dist/testing.js.map +1 -0
  51. package/dist/types.d.ts +29 -0
  52. package/dist/types.d.ts.map +1 -0
  53. package/dist/types.js +8 -0
  54. package/dist/types.js.map +1 -0
  55. package/examples/definitions/equipment-loan/equipment-loan-flow.state-machine.json +43 -0
  56. package/haneinfo.plugin.json +56 -0
  57. package/package.json +79 -3
  58. package/plugin.d.ts +2 -0
  59. package/plugin.js +4 -0
  60. package/prisma/state-machine.prisma +40 -0
  61. package/schemas/state-machine.spec.json +66 -0
  62. package/testing.d.ts +2 -0
  63. package/testing.js +2 -0
  64. package/README.md +0 -3
@@ -0,0 +1,76 @@
1
+ "use strict";
2
+ /** Prisma-backed instance store. Delegates are typed structurally; the App's client owns the real types. */
3
+ Object.defineProperty(exports, "__esModule", { value: true });
4
+ exports.PrismaStateMachineStore = void 0;
5
+ const toRecord = (row) => ({
6
+ ...row,
7
+ bundle: row.bundle,
8
+ data: (row.data ?? {}),
9
+ });
10
+ class PrismaTx {
11
+ constructor(db) {
12
+ this.db = db;
13
+ }
14
+ async create(input) {
15
+ const row = await this.db.stateMachineInstance.create({
16
+ data: {
17
+ machineCode: input.machineCode,
18
+ machineVersion: input.machineVersion,
19
+ bundle: input.bundle,
20
+ state: input.state,
21
+ data: input.data,
22
+ submitterId: input.submitterId,
23
+ finished: input.finished,
24
+ stateEnteredAt: input.stateEnteredAt,
25
+ startedAt: input.stateEnteredAt,
26
+ },
27
+ });
28
+ return toRecord(row);
29
+ }
30
+ async find(id, lock = false) {
31
+ if (lock)
32
+ await this.db.$queryRaw `SELECT id FROM state_machine_instances WHERE id = ${id} FOR UPDATE`;
33
+ const row = await this.db.stateMachineInstance.findUnique({ where: { id } });
34
+ return row ? toRecord(row) : null;
35
+ }
36
+ async update(id, expectedRevision, patch) {
37
+ const { count } = await this.db.stateMachineInstance.updateMany({
38
+ where: { id, revision: expectedRevision },
39
+ data: {
40
+ ...patch,
41
+ ...(patch.data ? { data: patch.data } : {}),
42
+ revision: { increment: 1 },
43
+ },
44
+ });
45
+ return count === 0 ? null : this.find(id);
46
+ }
47
+ async appendHistory(entry) {
48
+ await this.db.stateMachineTransition.create({ data: { ...entry } });
49
+ }
50
+ async history(instanceId) {
51
+ return this.db.stateMachineTransition.findMany({
52
+ where: { instanceId },
53
+ orderBy: [{ at: 'asc' }],
54
+ });
55
+ }
56
+ async list(filter) {
57
+ const rows = await this.db.stateMachineInstance.findMany({
58
+ where: { ...filter },
59
+ orderBy: [{ startedAt: 'desc' }],
60
+ take: 200,
61
+ });
62
+ return rows.map(toRecord);
63
+ }
64
+ }
65
+ class PrismaStateMachineStore {
66
+ constructor(prisma) {
67
+ this.prisma = prisma;
68
+ }
69
+ run(tx, work) {
70
+ if (tx !== undefined)
71
+ return work(new PrismaTx(tx), tx);
72
+ return this.prisma.$transaction((client) => work(new PrismaTx(client), client));
73
+ }
74
+ }
75
+ exports.PrismaStateMachineStore = PrismaStateMachineStore;
76
+ //# sourceMappingURL=prisma-store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"prisma-store.js","sourceRoot":"","sources":["../src/prisma-store.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,66 @@
1
+ /**
2
+ * The state-machine runtime (`haneinfo.state-machine-runtime`): business-object instances of
3
+ * published StateMachine definitions, their transitions and history.
4
+ *
5
+ * An instance pins its machine and everything the machine references when it starts
6
+ * (`resolveBundle`), so publishing a new version never changes a running instance. Listeners —
7
+ * Assignment, Timer — run inside the same transaction as the change that triggered them.
8
+ */
9
+ import { type DefinitionDiagnostic, type DefinitionRegistryPort, type MechanismEvent, type RbacPolicyPort, type StateMachineInstanceView, type StateMachineListener, type StateMachineRuntimePort, type StateMachineTrigger } from '@haneinfo/plugin-api';
10
+ import { type HistoryRecord, type InstanceFilter, type StateMachineStore } from './store';
11
+ export declare const INSTANCE_READ_PERMISSION = "state-machine:instance:read";
12
+ export declare const INSTANCE_WRITE_PERMISSION = "state-machine:instance:write";
13
+ export declare const STATE_MACHINE_CLOCK: unique symbol;
14
+ export type Clock = () => Date;
15
+ export declare class StateMachineRuntime implements StateMachineRuntimePort {
16
+ private readonly store;
17
+ private readonly registry;
18
+ private readonly rbac?;
19
+ private readonly listeners;
20
+ private readonly dispatches;
21
+ private readonly now;
22
+ constructor(store: StateMachineStore, registry: DefinitionRegistryPort, rbac?: RbacPolicyPort | undefined, clock?: Clock);
23
+ addListener(listener: StateMachineListener): void;
24
+ start(input: {
25
+ machine: string;
26
+ data?: Record<string, unknown>;
27
+ submitterId: string | null;
28
+ }, tx?: unknown): Promise<StateMachineInstanceView>;
29
+ transition(input: {
30
+ instanceId: string;
31
+ transition: string;
32
+ trigger: StateMachineTrigger;
33
+ expectedRevision?: number;
34
+ }, tx?: unknown): Promise<StateMachineInstanceView>;
35
+ /** Replaces the instance data. Not in a frozen state; the submitter, or `state-machine:instance:write`. */
36
+ updateData(input: {
37
+ instanceId: string;
38
+ data: Record<string, unknown>;
39
+ userId: string;
40
+ expectedRevision: number;
41
+ }, tx?: unknown): Promise<{
42
+ instance: StateMachineInstanceView;
43
+ diagnostics: DefinitionDiagnostic[];
44
+ }>;
45
+ get(instanceId: string, tx?: unknown, options?: {
46
+ lock?: boolean;
47
+ }): Promise<StateMachineInstanceView | null>;
48
+ /** For a person: the instance, if they started it or hold `state-machine:instance:read`. */
49
+ getFor(userId: string, instanceId: string): Promise<{
50
+ instance: StateMachineInstanceView;
51
+ history: HistoryRecord[];
52
+ }>;
53
+ listFor(userId: string, filter: InstanceFilter & {
54
+ mine?: boolean;
55
+ }): Promise<StateMachineInstanceView[]>;
56
+ history(instanceId: string, tx?: unknown): Promise<HistoryRecord[]>;
57
+ emit(event: Omit<MechanismEvent, 'tx'>, tx?: unknown): Promise<void>;
58
+ private entered;
59
+ private prepare;
60
+ private authorizeTransition;
61
+ private authorizeRead;
62
+ private require;
63
+ private conflict;
64
+ private forbidden;
65
+ }
66
+ //# sourceMappingURL=runtime.service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime.service.d.ts","sourceRoot":"","sources":["../src/runtime.service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,292 @@
1
+ "use strict";
2
+ /**
3
+ * The state-machine runtime (`haneinfo.state-machine-runtime`): business-object instances of
4
+ * published StateMachine definitions, their transitions and history.
5
+ *
6
+ * An instance pins its machine and everything the machine references when it starts
7
+ * (`resolveBundle`), so publishing a new version never changes a running instance. Listeners —
8
+ * Assignment, Timer — run inside the same transaction as the change that triggered them.
9
+ */
10
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
11
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
12
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
13
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
14
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
15
+ };
16
+ var __metadata = (this && this.__metadata) || function (k, v) {
17
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
18
+ };
19
+ var __param = (this && this.__param) || function (paramIndex, decorator) {
20
+ return function (target, key) { decorator(target, key, paramIndex); }
21
+ };
22
+ Object.defineProperty(exports, "__esModule", { value: true });
23
+ exports.StateMachineRuntime = exports.STATE_MACHINE_CLOCK = exports.INSTANCE_WRITE_PERMISSION = exports.INSTANCE_READ_PERMISSION = void 0;
24
+ const plugin_api_1 = require("@haneinfo/plugin-api");
25
+ const common_1 = require("@nestjs/common");
26
+ const kind_1 = require("./kind");
27
+ const store_1 = require("./store");
28
+ const types_1 = require("./types");
29
+ exports.INSTANCE_READ_PERMISSION = 'state-machine:instance:read';
30
+ exports.INSTANCE_WRITE_PERMISSION = 'state-machine:instance:write';
31
+ exports.STATE_MACHINE_CLOCK = Symbol.for('haneinfo.state-machine.clock');
32
+ function specOf(bundle) {
33
+ return bundle.root.definition.spec;
34
+ }
35
+ function toView(record) {
36
+ return {
37
+ id: record.id,
38
+ machine: { kind: kind_1.STATE_MACHINE_KIND, code: record.machineCode },
39
+ bundle: record.bundle,
40
+ state: record.state,
41
+ data: record.data,
42
+ submitterId: record.submitterId,
43
+ revision: record.revision,
44
+ startedAt: new Date(record.startedAt),
45
+ stateEnteredAt: new Date(record.stateEnteredAt),
46
+ finished: record.finished,
47
+ };
48
+ }
49
+ let StateMachineRuntime = class StateMachineRuntime {
50
+ constructor(store, registry, rbac, clock) {
51
+ this.store = store;
52
+ this.registry = registry;
53
+ this.rbac = rbac;
54
+ this.listeners = [];
55
+ this.dispatches = new Map();
56
+ this.now = clock ?? (() => new Date());
57
+ }
58
+ addListener(listener) {
59
+ this.listeners.push(listener);
60
+ }
61
+ async start(input, tx) {
62
+ const bundle = await this.registry.resolveBundle({
63
+ kind: kind_1.STATE_MACHINE_KIND,
64
+ code: input.machine,
65
+ });
66
+ const spec = specOf(bundle);
67
+ const initial = (0, types_1.initialStateOf)(spec);
68
+ if (!initial) {
69
+ throw new plugin_api_1.MechanismError('NO_INITIAL_STATE', `StateMachine/${input.machine} has no INITIAL state`, 409);
70
+ }
71
+ // Incomplete data is fine while the instance sits in its initial state; every transition
72
+ // re-validates it (see `transition`).
73
+ const { data } = this.prepare(bundle, input.data ?? {});
74
+ return this.store.run(tx, async (store, t) => {
75
+ const at = this.now();
76
+ const record = await store.create({
77
+ machineCode: input.machine,
78
+ machineVersion: bundle.root.version,
79
+ bundle,
80
+ state: initial.key,
81
+ data,
82
+ submitterId: input.submitterId,
83
+ finished: initial.type === 'FINAL',
84
+ stateEnteredAt: at,
85
+ });
86
+ await store.appendHistory({
87
+ instanceId: record.id,
88
+ transition: null,
89
+ fromState: null,
90
+ toState: initial.key,
91
+ triggerType: 'START',
92
+ triggerUserId: input.submitterId,
93
+ triggerRef: null,
94
+ at,
95
+ });
96
+ const view = toView(record);
97
+ for (const listener of this.listeners)
98
+ await listener.onStarted?.({ instance: view, tx: t });
99
+ await this.entered({
100
+ instance: view,
101
+ previousState: null,
102
+ transition: null,
103
+ trigger: null,
104
+ tx: t,
105
+ });
106
+ return toView((await store.find(record.id)));
107
+ });
108
+ }
109
+ async transition(input, tx) {
110
+ return this.store.run(tx, async (store, t) => {
111
+ const record = await this.require(store, input.instanceId, true);
112
+ if (record.finished) {
113
+ throw new plugin_api_1.MechanismError('INSTANCE_FINISHED', 'The instance is in a FINAL state', 409, 'Start a new instance instead');
114
+ }
115
+ if (input.expectedRevision !== undefined && input.expectedRevision !== record.revision) {
116
+ throw this.conflict(record);
117
+ }
118
+ const spec = specOf(record.bundle);
119
+ const transition = spec.transitions.find((candidate) => candidate.key === input.transition);
120
+ const available = spec.transitions.filter((candidate) => candidate.from.includes(record.state));
121
+ if (!transition?.from.includes(record.state)) {
122
+ throw new plugin_api_1.MechanismError(transition ? 'TRANSITION_NOT_AVAILABLE' : 'UNKNOWN_TRANSITION', transition
123
+ ? `"${input.transition}" cannot be taken from "${record.state}"`
124
+ : `"${input.transition}" is not a transition of StateMachine/${record.machineCode}`, 409, `From "${record.state}" you can take: ${available.map((candidate) => candidate.key).join(', ') || '(nothing)'}`);
125
+ }
126
+ if (input.trigger.type === 'USER')
127
+ await this.authorizeTransition(input.trigger.userId, record, transition);
128
+ const prepared = this.prepare(record.bundle, record.data);
129
+ if ((0, plugin_api_1.hasDefinitionErrors)(prepared.diagnostics)) {
130
+ throw new plugin_api_1.MechanismError('INVALID_DATA', 'The instance data is not complete or not valid for this transition', 422, 'Fix the listed values and try again', prepared.diagnostics);
131
+ }
132
+ const target = spec.states.find((state) => state.key === transition.to);
133
+ const at = this.now();
134
+ const updated = await store.update(record.id, record.revision, {
135
+ state: transition.to,
136
+ data: prepared.data,
137
+ finished: target?.type === 'FINAL',
138
+ stateEnteredAt: at,
139
+ });
140
+ if (!updated)
141
+ throw this.conflict(record);
142
+ await store.appendHistory({
143
+ instanceId: record.id,
144
+ transition: transition.key,
145
+ fromState: record.state,
146
+ toState: transition.to,
147
+ triggerType: input.trigger.type,
148
+ triggerUserId: input.trigger.type === 'TIMER' ? null : input.trigger.userId,
149
+ triggerRef: input.trigger.type === 'ASSIGNMENT'
150
+ ? input.trigger.assignmentCode
151
+ : input.trigger.type === 'TIMER'
152
+ ? input.trigger.timerCode
153
+ : null,
154
+ at,
155
+ });
156
+ const view = toView(updated);
157
+ await this.entered({
158
+ instance: view,
159
+ previousState: record.state,
160
+ transition: transition.key,
161
+ trigger: input.trigger,
162
+ tx: t,
163
+ });
164
+ return toView(await this.require(store, record.id));
165
+ });
166
+ }
167
+ /** Replaces the instance data. Not in a frozen state; the submitter, or `state-machine:instance:write`. */
168
+ async updateData(input, tx) {
169
+ return this.store.run(tx, async (store) => {
170
+ const record = await this.require(store, input.instanceId, true);
171
+ if (record.revision !== input.expectedRevision)
172
+ throw this.conflict(record);
173
+ const state = specOf(record.bundle).states.find((candidate) => candidate.key === record.state);
174
+ if (state?.frozen || record.finished) {
175
+ throw new plugin_api_1.MechanismError('STATE_FROZEN', `Data cannot change while the instance is "${record.state}"`, 409);
176
+ }
177
+ if (record.submitterId !== input.userId) {
178
+ const authorization = await (0, plugin_api_1.authorizationOfUser)(this.rbac, input.userId);
179
+ if (!(0, plugin_api_1.hasPermission)(authorization, exports.INSTANCE_WRITE_PERMISSION))
180
+ throw this.forbidden(exports.INSTANCE_WRITE_PERMISSION);
181
+ }
182
+ const prepared = this.prepare(record.bundle, input.data);
183
+ const updated = await store.update(record.id, record.revision, { data: prepared.data });
184
+ if (!updated)
185
+ throw this.conflict(record);
186
+ return { instance: toView(updated), diagnostics: prepared.diagnostics };
187
+ });
188
+ }
189
+ async get(instanceId, tx, options) {
190
+ if (options?.lock && tx === undefined)
191
+ throw new plugin_api_1.MechanismError('TRANSACTION_REQUIRED', 'An instance lock requires the caller transaction', 500);
192
+ return this.store.run(tx, async (store) => {
193
+ const record = await store.find(instanceId, options?.lock);
194
+ return record ? toView(record) : null;
195
+ });
196
+ }
197
+ /** For a person: the instance, if they started it or hold `state-machine:instance:read`. */
198
+ async getFor(userId, instanceId) {
199
+ return this.store.run(undefined, async (store) => {
200
+ const record = await this.require(store, instanceId);
201
+ await this.authorizeRead(userId, record);
202
+ return { instance: toView(record), history: await store.history(record.id) };
203
+ });
204
+ }
205
+ async listFor(userId, filter) {
206
+ const authorization = await (0, plugin_api_1.authorizationOfUser)(this.rbac, userId);
207
+ const all = !filter.mine && (0, plugin_api_1.hasPermission)(authorization, exports.INSTANCE_READ_PERMISSION);
208
+ const { mine: _mine, ...rest } = filter;
209
+ return this.store.run(undefined, async (store) => (await store.list(all ? rest : { ...rest, submitterId: userId })).map(toView));
210
+ }
211
+ async history(instanceId, tx) {
212
+ return this.store.run(tx, (store) => store.history(instanceId));
213
+ }
214
+ async emit(event, tx) {
215
+ await this.store.run(tx, async (_store, t) => {
216
+ for (const listener of this.listeners)
217
+ await listener.onEvent?.({ ...event, tx: t });
218
+ });
219
+ }
220
+ // --- Helpers -----------------------------------------------------------------------------
221
+ async entered(event) {
222
+ const entries = this.dispatches.get(event.tx) ?? new Map();
223
+ const token = {};
224
+ this.dispatches.set(event.tx, entries);
225
+ entries.set(event.instance.id, token);
226
+ try {
227
+ for (const listener of this.listeners) {
228
+ // A nested transition already dispatched the newer state. Do not let remaining
229
+ // listeners arm tasks or timers from the outer event's obsolete snapshot.
230
+ if (entries.get(event.instance.id) !== token)
231
+ break;
232
+ await listener.onStateEntered?.(event);
233
+ }
234
+ }
235
+ finally {
236
+ if (entries.get(event.instance.id) === token)
237
+ entries.delete(event.instance.id);
238
+ if (entries.size === 0 && this.dispatches.get(event.tx) === entries)
239
+ this.dispatches.delete(event.tx);
240
+ }
241
+ }
242
+ prepare(bundle, data) {
243
+ const subject = specOf(bundle).subject;
244
+ if (!subject)
245
+ return { data, diagnostics: [] };
246
+ const pinned = bundle.definitions[(0, plugin_api_1.definitionRefKey)(subject)];
247
+ const prepared = pinned ? this.registry.prepareData(pinned.definition, data) : null;
248
+ if (!prepared)
249
+ throw new plugin_api_1.MechanismError('SUBJECT_UNAVAILABLE', 'The pinned subject or its data validator is missing', 500);
250
+ return prepared;
251
+ }
252
+ async authorizeTransition(userId, record, transition) {
253
+ if (transition.permission) {
254
+ const authorization = await (0, plugin_api_1.authorizationOfUser)(this.rbac, userId);
255
+ if (!(0, plugin_api_1.hasPermission)(authorization, transition.permission))
256
+ throw this.forbidden(transition.permission);
257
+ return;
258
+ }
259
+ await this.authorizeRead(userId, record);
260
+ }
261
+ async authorizeRead(userId, record) {
262
+ if (record.submitterId === userId)
263
+ return;
264
+ const authorization = await (0, plugin_api_1.authorizationOfUser)(this.rbac, userId);
265
+ if (!(0, plugin_api_1.hasPermission)(authorization, exports.INSTANCE_READ_PERMISSION))
266
+ throw this.forbidden(exports.INSTANCE_READ_PERMISSION);
267
+ }
268
+ async require(store, id, lock = false) {
269
+ const record = await store.find(id, lock);
270
+ if (!record)
271
+ throw new plugin_api_1.MechanismError('INSTANCE_NOT_FOUND', `Instance ${id} does not exist`, 404);
272
+ return record;
273
+ }
274
+ conflict(record) {
275
+ return new plugin_api_1.MechanismError('VERSION_CONFLICT', 'The instance changed since you read it', 409, 'Read it again and retry against the new revision', [], { currentRevision: record.revision });
276
+ }
277
+ forbidden(permission) {
278
+ return new plugin_api_1.MechanismError('FORBIDDEN', `Missing permission ${permission}`, 403, `Ask an administrator for ${permission}`);
279
+ }
280
+ };
281
+ exports.StateMachineRuntime = StateMachineRuntime;
282
+ exports.StateMachineRuntime = StateMachineRuntime = __decorate([
283
+ (0, common_1.Injectable)(),
284
+ __param(0, (0, common_1.Inject)(store_1.STATE_MACHINE_STORE)),
285
+ __param(1, (0, common_1.Inject)(plugin_api_1.DEFINITION_REGISTRY)),
286
+ __param(2, (0, common_1.Optional)()),
287
+ __param(2, (0, common_1.Inject)(plugin_api_1.RBAC_POLICY)),
288
+ __param(3, (0, common_1.Optional)()),
289
+ __param(3, (0, common_1.Inject)(exports.STATE_MACHINE_CLOCK)),
290
+ __metadata("design:paramtypes", [Object, Object, Object, Function])
291
+ ], StateMachineRuntime);
292
+ //# sourceMappingURL=runtime.service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime.service.js","sourceRoot":"","sources":["../src/runtime.service.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;AAEH,qDAkB8B;AAC9B,2CAA8D;AAC9D,iCAA4C;AAC5C,mCAMiB;AACjB,mCAA2F;AAE9E,QAAA,wBAAwB,GAAG,6BAA6B,CAAC;AACzD,QAAA,yBAAyB,GAAG,8BAA8B,CAAC;AAE3D,QAAA,mBAAmB,GAAG,MAAM,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;AAG9E,SAAS,MAAM,CAAC,MAAgC;IAC9C,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,IAAwB,CAAC;AACzD,CAAC;AAED,SAAS,MAAM,CAAC,MAAsB;IACpC,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,OAAO,EAAE,EAAE,IAAI,EAAE,yBAAkB,EAAE,IAAI,EAAE,MAAM,CAAC,WAAW,EAAE;QAC/D,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;QACrC,cAAc,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;QAC/C,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;AACJ,CAAC;AAGM,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAK9B,YAC+B,KAAyC,EACzC,QAAiD,EAC7C,IAAsC,EAC9B,KAAa;QAHR,UAAK,GAAL,KAAK,CAAmB;QACxB,aAAQ,GAAR,QAAQ,CAAwB;QAC5B,SAAI,GAAJ,IAAI,CAAiB;QAPxD,cAAS,GAA2B,EAAE,CAAC;QACvC,eAAU,GAAG,IAAI,GAAG,EAAgC,CAAC;QASpE,IAAI,CAAC,GAAG,GAAG,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,WAAW,CAAC,QAA8B;QACxC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,KAAK,CACT,KAAsF,EACtF,EAAY;QAEZ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;YAC/C,IAAI,EAAE,yBAAkB;YACxB,IAAI,EAAE,KAAK,CAAC,OAAO;SACpB,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAA,sBAAc,EAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,2BAAc,CACtB,kBAAkB,EAClB,gBAAgB,KAAK,CAAC,OAAO,uBAAuB,EACpD,GAAG,CACJ,CAAC;QACJ,CAAC;QACD,yFAAyF;QACzF,sCAAsC;QACtC,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YAC3C,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC;gBAChC,WAAW,EAAE,KAAK,CAAC,OAAO;gBAC1B,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO;gBACnC,MAAM;gBACN,KAAK,EAAE,OAAO,CAAC,GAAG;gBAClB,IAAI;gBACJ,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,QAAQ,EAAE,OAAO,CAAC,IAAI,KAAK,OAAO;gBAClC,cAAc,EAAE,EAAE;aACnB,CAAC,CAAC;YACH,MAAM,KAAK,CAAC,aAAa,CAAC;gBACxB,UAAU,EAAE,MAAM,CAAC,EAAE;gBACrB,UAAU,EAAE,IAAI;gBAChB,SAAS,EAAE,IAAI;gBACf,OAAO,EAAE,OAAO,CAAC,GAAG;gBACpB,WAAW,EAAE,OAAO;gBACpB,aAAa,EAAE,KAAK,CAAC,WAAW;gBAChC,UAAU,EAAE,IAAI;gBAChB,EAAE;aACH,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAC5B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS;gBAAE,MAAM,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;YAC7F,MAAM,IAAI,CAAC,OAAO,CAAC;gBACjB,QAAQ,EAAE,IAAI;gBACd,aAAa,EAAE,IAAI;gBACnB,UAAU,EAAE,IAAI;gBAChB,OAAO,EAAE,IAAI;gBACb,EAAE,EAAE,CAAC;aACN,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAmB,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,UAAU,CACd,KAKC,EACD,EAAY;QAEZ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YAC3C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YACjE,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACpB,MAAM,IAAI,2BAAc,CACtB,mBAAmB,EACnB,kCAAkC,EAClC,GAAG,EACH,8BAA8B,CAC/B,CAAC;YACJ,CAAC;YACD,IAAI,KAAK,CAAC,gBAAgB,KAAK,SAAS,IAAI,KAAK,CAAC,gBAAgB,KAAK,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACvF,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC9B,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACnC,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,KAAK,KAAK,CAAC,UAAU,CAAC,CAAC;YAC5F,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CACtD,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CACtC,CAAC;YACF,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7C,MAAM,IAAI,2BAAc,CACtB,UAAU,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,oBAAoB,EAC9D,UAAU;oBACR,CAAC,CAAC,IAAI,KAAK,CAAC,UAAU,2BAA2B,MAAM,CAAC,KAAK,GAAG;oBAChE,CAAC,CAAC,IAAI,KAAK,CAAC,UAAU,yCAAyC,MAAM,CAAC,WAAW,EAAE,EACrF,GAAG,EACH,SAAS,MAAM,CAAC,KAAK,mBAAmB,SAAS,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,WAAW,EAAE,CAChH,CAAC;YACJ,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM;gBAC/B,MAAM,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;YAE3E,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YAC1D,IAAI,IAAA,gCAAmB,EAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC9C,MAAM,IAAI,2BAAc,CACtB,cAAc,EACd,oEAAoE,EACpE,GAAG,EACH,qCAAqC,EACrC,QAAQ,CAAC,WAAW,CACrB,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK,UAAU,CAAC,EAAE,CAAC,CAAC;YACxE,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,QAAQ,EAAE;gBAC7D,KAAK,EAAE,UAAU,CAAC,EAAE;gBACpB,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,QAAQ,EAAE,MAAM,EAAE,IAAI,KAAK,OAAO;gBAClC,cAAc,EAAE,EAAE;aACnB,CAAC,CAAC;YACH,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC1C,MAAM,KAAK,CAAC,aAAa,CAAC;gBACxB,UAAU,EAAE,MAAM,CAAC,EAAE;gBACrB,UAAU,EAAE,UAAU,CAAC,GAAG;gBAC1B,SAAS,EAAE,MAAM,CAAC,KAAK;gBACvB,OAAO,EAAE,UAAU,CAAC,EAAE;gBACtB,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI;gBAC/B,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM;gBAC3E,UAAU,EACR,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,YAAY;oBACjC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc;oBAC9B,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO;wBAC9B,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS;wBACzB,CAAC,CAAC,IAAI;gBACZ,EAAE;aACH,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;YAC7B,MAAM,IAAI,CAAC,OAAO,CAAC;gBACjB,QAAQ,EAAE,IAAI;gBACd,aAAa,EAAE,MAAM,CAAC,KAAK;gBAC3B,UAAU,EAAE,UAAU,CAAC,GAAG;gBAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,EAAE,EAAE,CAAC;aACN,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,2GAA2G;IAC3G,KAAK,CAAC,UAAU,CACd,KAKC,EACD,EAAY;QAEZ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACxC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YACjE,IAAI,MAAM,CAAC,QAAQ,KAAK,KAAK,CAAC,gBAAgB;gBAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC5E,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAC7C,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,KAAK,MAAM,CAAC,KAAK,CAC9C,CAAC;YACF,IAAI,KAAK,EAAE,MAAM,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACrC,MAAM,IAAI,2BAAc,CACtB,cAAc,EACd,6CAA6C,MAAM,CAAC,KAAK,GAAG,EAC5D,GAAG,CACJ,CAAC;YACJ,CAAC;YACD,IAAI,MAAM,CAAC,WAAW,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;gBACxC,MAAM,aAAa,GAAG,MAAM,IAAA,gCAAmB,EAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;gBACzE,IAAI,CAAC,IAAA,0BAAa,EAAC,aAAa,EAAE,iCAAyB,CAAC;oBAC1D,MAAM,IAAI,CAAC,SAAS,CAAC,iCAAyB,CAAC,CAAC;YACpD,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACzD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;YACxF,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC1E,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,GAAG,CACP,UAAkB,EAClB,EAAY,EACZ,OAA4B;QAE5B,IAAI,OAAO,EAAE,IAAI,IAAI,EAAE,KAAK,SAAS;YACnC,MAAM,IAAI,2BAAc,CACtB,sBAAsB,EACtB,kDAAkD,EAClD,GAAG,CACJ,CAAC;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACxC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;YAC3D,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,4FAA4F;IAC5F,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,UAAkB;QAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YAC/C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;YACrD,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QAC/E,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO,CACX,MAAc,EACd,MAA2C;QAE3C,MAAM,aAAa,GAAG,MAAM,IAAA,gCAAmB,EAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACnE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,IAAA,0BAAa,EAAC,aAAa,EAAE,gCAAwB,CAAC,CAAC;QACnF,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACxC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAC/C,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAC9E,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAAkB,EAAE,EAAY;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAiC,EAAE,EAAY;QACxD,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE;YAC3C,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS;gBAAE,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;QACvF,CAAC,CAAC,CAAC;IACL,CAAC;IAED,4FAA4F;IAEpF,KAAK,CAAC,OAAO,CAAC,KAAoC;QACxD,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,IAAI,GAAG,EAAkB,CAAC;QAC3E,MAAM,KAAK,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC;YACH,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACtC,+EAA+E;gBAC/E,0EAA0E;gBAC1E,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,KAAK;oBAAE,MAAM;gBACpD,MAAM,QAAQ,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,KAAK;gBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAChF,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,OAAO;gBACjE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAEO,OAAO,CAAC,MAAgC,EAAE,IAA6B;QAC7E,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;QACvC,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,EAA4B,EAAE,CAAC;QACzE,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,IAAA,6BAAgB,EAAC,OAAO,CAAC,CAAC,CAAC;QAC7D,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACpF,IAAI,CAAC,QAAQ;YACX,MAAM,IAAI,2BAAc,CACtB,qBAAqB,EACrB,qDAAqD,EACrD,GAAG,CACJ,CAAC;QACJ,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,KAAK,CAAC,mBAAmB,CAC/B,MAAc,EACd,MAAsB,EACtB,UAAgC;QAEhC,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;YAC1B,MAAM,aAAa,GAAG,MAAM,IAAA,gCAAmB,EAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACnE,IAAI,CAAC,IAAA,0BAAa,EAAC,aAAa,EAAE,UAAU,CAAC,UAAU,CAAC;gBACtD,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YAC9C,OAAO;QACT,CAAC;QACD,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,MAAc,EAAE,MAAsB;QAChE,IAAI,MAAM,CAAC,WAAW,KAAK,MAAM;YAAE,OAAO;QAC1C,MAAM,aAAa,GAAG,MAAM,IAAA,gCAAmB,EAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACnE,IAAI,CAAC,IAAA,0BAAa,EAAC,aAAa,EAAE,gCAAwB,CAAC;YACzD,MAAM,IAAI,CAAC,SAAS,CAAC,gCAAwB,CAAC,CAAC;IACnD,CAAC;IAEO,KAAK,CAAC,OAAO,CACnB,KAA6D,EAC7D,EAAU,EACV,IAAI,GAAG,KAAK;QAEZ,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM;YACT,MAAM,IAAI,2BAAc,CAAC,oBAAoB,EAAE,YAAY,EAAE,iBAAiB,EAAE,GAAG,CAAC,CAAC;QACvF,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,QAAQ,CAAC,MAAsB;QACrC,OAAO,IAAI,2BAAc,CACvB,kBAAkB,EAClB,wCAAwC,EACxC,GAAG,EACH,kDAAkD,EAClD,EAAE,EACF,EAAE,eAAe,EAAE,MAAM,CAAC,QAAQ,EAAE,CACrC,CAAC;IACJ,CAAC;IAEO,SAAS,CAAC,UAAkB;QAClC,OAAO,IAAI,2BAAc,CACvB,WAAW,EACX,sBAAsB,UAAU,EAAE,EAClC,GAAG,EACH,4BAA4B,UAAU,EAAE,CACzC,CAAC;IACJ,CAAC;CACF,CAAA;AAxUY,kDAAmB;8BAAnB,mBAAmB;IAD/B,IAAA,mBAAU,GAAE;IAOR,WAAA,IAAA,eAAM,EAAC,2BAAmB,CAAC,CAAA;IAC3B,WAAA,IAAA,eAAM,EAAC,gCAAmB,CAAC,CAAA;IAC3B,WAAA,IAAA,iBAAQ,GAAE,CAAA;IAAE,WAAA,IAAA,eAAM,EAAC,wBAAW,CAAC,CAAA;IAC/B,WAAA,IAAA,iBAAQ,GAAE,CAAA;IAAE,WAAA,IAAA,eAAM,EAAC,2BAAmB,CAAC,CAAA;;GAT/B,mBAAmB,CAwU/B"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Semantic rules of a StateMachine spec. The JSON Schema has already passed; references to other
3
+ * definitions (the subject) are checked by the registry.
4
+ */
5
+ import { type DefinitionDiagnostic } from '@haneinfo/plugin-api';
6
+ import type { StateMachineSpec } from './types';
7
+ export declare function validateStateMachineSpec(spec: StateMachineSpec): DefinitionDiagnostic[];
8
+ //# sourceMappingURL=semantics.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"semantics.d.ts","sourceRoot":"","sources":["../src/semantics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,KAAK,oBAAoB,EAG1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,GAAG,oBAAoB,EAAE,CAiIvF"}
@@ -0,0 +1,83 @@
1
+ "use strict";
2
+ /**
3
+ * Semantic rules of a StateMachine spec. The JSON Schema has already passed; references to other
4
+ * definitions (the subject) are checked by the registry.
5
+ */
6
+ Object.defineProperty(exports, "__esModule", { value: true });
7
+ exports.validateStateMachineSpec = validateStateMachineSpec;
8
+ const plugin_api_1 = require("@haneinfo/plugin-api");
9
+ function validateStateMachineSpec(spec) {
10
+ const diagnostics = [];
11
+ const add = (code, message, segments, suggestion, severity = 'ERROR') => diagnostics.push((0, plugin_api_1.definitionDiagnostic)(code, message, (0, plugin_api_1.toJsonPointer)(['spec', ...segments]), {
12
+ suggestion,
13
+ severity,
14
+ }));
15
+ const states = new Map();
16
+ spec.states.forEach((state, index) => {
17
+ if (states.has(state.key)) {
18
+ add('DUPLICATE_STATE_KEY', `state key "${state.key}" is used twice`, ['states', index, 'key'], 'Give every state a unique key');
19
+ }
20
+ else
21
+ states.set(state.key, index);
22
+ });
23
+ const initial = spec.states.filter((state) => state.type === 'INITIAL');
24
+ if (initial.length === 0) {
25
+ add('NO_INITIAL_STATE', 'a state machine needs exactly one INITIAL state', ['states'], 'Set type "INITIAL" on the state instances start in');
26
+ }
27
+ else if (initial.length > 1) {
28
+ spec.states.forEach((state, index) => {
29
+ if (state.type === 'INITIAL' && state !== initial[0]) {
30
+ add('MULTIPLE_INITIAL_STATES', 'only one state can be INITIAL', ['states', index, 'type'], 'Change it to "NORMAL"');
31
+ }
32
+ });
33
+ }
34
+ const transitionKeys = new Set();
35
+ const outgoing = new Map();
36
+ const edges = new Map();
37
+ spec.transitions.forEach((transition, index) => {
38
+ if (transitionKeys.has(transition.key)) {
39
+ add('DUPLICATE_TRANSITION_KEY', `transition key "${transition.key}" is used twice`, ['transitions', index, 'key'], 'Give every transition a unique key');
40
+ }
41
+ transitionKeys.add(transition.key);
42
+ if (!states.has(transition.to)) {
43
+ add('UNKNOWN_STATE', `"${transition.to}" is not a state`, ['transitions', index, 'to'], `Use one of: ${[...states.keys()].join(', ')}`);
44
+ }
45
+ transition.from.forEach((from, at) => {
46
+ const fromIndex = states.get(from);
47
+ if (fromIndex === undefined) {
48
+ add('UNKNOWN_STATE', `"${from}" is not a state`, ['transitions', index, 'from', at], `Use one of: ${[...states.keys()].join(', ')}`);
49
+ return;
50
+ }
51
+ if (spec.states[fromIndex]?.type === 'FINAL') {
52
+ add('FINAL_STATE_HAS_TRANSITION', `"${from}" is FINAL, so nothing can leave it`, ['transitions', index, 'from', at], 'Remove it from "from", or make the state NORMAL');
53
+ }
54
+ outgoing.set(from, (outgoing.get(from) ?? 0) + 1);
55
+ const targets = edges.get(from) ?? new Set();
56
+ targets.add(transition.to);
57
+ edges.set(from, targets);
58
+ });
59
+ });
60
+ const start = initial[0]?.key;
61
+ if (start) {
62
+ const reached = new Set([start]);
63
+ const queue = [start];
64
+ while (queue.length > 0) {
65
+ for (const next of edges.get(queue.shift()) ?? []) {
66
+ if (!reached.has(next)) {
67
+ reached.add(next);
68
+ queue.push(next);
69
+ }
70
+ }
71
+ }
72
+ spec.states.forEach((state, index) => {
73
+ if (!reached.has(state.key)) {
74
+ add('UNREACHABLE_STATE', `no transition path leads from "${start}" to "${state.key}"`, ['states', index], 'Add a transition into it or remove it', 'WARNING');
75
+ }
76
+ else if (state.type !== 'FINAL' && !outgoing.has(state.key)) {
77
+ add('DEAD_END_STATE', `"${state.key}" is not FINAL but has no way out`, ['states', index], 'Add a transition out of it or make it FINAL', 'WARNING');
78
+ }
79
+ });
80
+ }
81
+ return diagnostics;
82
+ }
83
+ //# sourceMappingURL=semantics.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"semantics.js","sourceRoot":"","sources":["../src/semantics.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,20 @@
1
+ /** Dry run of a transition path, for `simulate_state_machine`. Pure: nothing is stored. */
2
+ import { type DefinitionDiagnostic } from '@haneinfo/plugin-api';
3
+ import { type StateMachineSpec } from './types';
4
+ export interface SimulationStep {
5
+ transition: string;
6
+ from: string;
7
+ to: string;
8
+ }
9
+ export interface SimulationResult {
10
+ /** True when every transition could be taken. */
11
+ ok: boolean;
12
+ steps: SimulationStep[];
13
+ state: string | null;
14
+ finished: boolean;
15
+ /** Transitions available from the state reached. */
16
+ available: string[];
17
+ diagnostics: DefinitionDiagnostic[];
18
+ }
19
+ export declare function simulateStateMachine(spec: StateMachineSpec, path: readonly string[]): SimulationResult;
20
+ //# sourceMappingURL=simulate.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"simulate.d.ts","sourceRoot":"","sources":["../src/simulate.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAE3F,OAAO,EACL,KAAK,oBAAoB,EAG1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhE,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,oDAAoD;IACpD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,gBAAgB,CAgDlB"}
@@ -0,0 +1,46 @@
1
+ "use strict";
2
+ /** Dry run of a transition path, for `simulate_state_machine`. Pure: nothing is stored. */
3
+ Object.defineProperty(exports, "__esModule", { value: true });
4
+ exports.simulateStateMachine = simulateStateMachine;
5
+ const plugin_api_1 = require("@haneinfo/plugin-api");
6
+ const types_1 = require("./types");
7
+ function simulateStateMachine(spec, path) {
8
+ const steps = [];
9
+ const available = (state) => spec.transitions
10
+ .filter((transition) => transition.from.includes(state))
11
+ .map((transition) => transition.key);
12
+ const typeOf = (state) => spec.states.find((candidate) => candidate.key === state)?.type;
13
+ let state = (0, types_1.initialStateOf)(spec)?.key ?? null;
14
+ const diagnostics = [];
15
+ if (!state) {
16
+ diagnostics.push((0, plugin_api_1.definitionDiagnostic)('NO_INITIAL_STATE', 'the machine has no INITIAL state', '/spec/states'));
17
+ return { ok: false, steps, state, finished: false, available: [], diagnostics };
18
+ }
19
+ for (const [index, key] of path.entries()) {
20
+ const transition = spec.transitions.find((candidate) => candidate.key === key);
21
+ if (!transition?.from.includes(state)) {
22
+ diagnostics.push((0, plugin_api_1.definitionDiagnostic)(transition ? 'TRANSITION_NOT_AVAILABLE' : 'UNKNOWN_TRANSITION', transition ? `"${key}" cannot be taken from "${state}"` : `"${key}" is not a transition`, (0, plugin_api_1.toJsonPointer)(['path', index]), {
23
+ suggestion: `From "${state}" you can take: ${available(state).join(', ') || '(nothing)'}`,
24
+ }));
25
+ return {
26
+ ok: false,
27
+ steps,
28
+ state,
29
+ finished: typeOf(state) === 'FINAL',
30
+ available: available(state),
31
+ diagnostics,
32
+ };
33
+ }
34
+ steps.push({ transition: key, from: state, to: transition.to });
35
+ state = transition.to;
36
+ }
37
+ return {
38
+ ok: true,
39
+ steps,
40
+ state,
41
+ finished: typeOf(state) === 'FINAL',
42
+ available: available(state),
43
+ diagnostics,
44
+ };
45
+ }
46
+ //# sourceMappingURL=simulate.js.map