@posiwise/flows 0.0.2 → 0.0.4

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.
@@ -3,9 +3,9 @@ import { AfterViewChecked, AfterViewInit, ChangeDetectorRef, DestroyRef, Element
3
3
  import * as i1 from "@angular/router";
4
4
  import { LazyLoadEvent, MenuItem } from "primeng/api";
5
5
  import { AppBaseComponent } from "@posiwise/app-base-component";
6
- import * as i26 from "@posiwise/shared-components";
6
+ import * as i33 from "@posiwise/shared-components";
7
7
  import { ConfirmDialogService } from "@posiwise/shared-components";
8
- import * as i22 from "@angular/forms";
8
+ import * as i29 from "@angular/forms";
9
9
  import { UntypedFormGroup } from "@angular/forms";
10
10
  import { Paging } from "@posiwise/common-utilities";
11
11
  import { ProductsHttpService } from "@posiwise/shared-product-services";
@@ -14,16 +14,18 @@ import { PermissionService, SubscriptionService } from "@posiwise/common-service
14
14
  import { TranslocoService } from "@jsverse/transloco";
15
15
  import { ClassicPreset, GetSchemes } from "rete";
16
16
  import { IconDefinition } from "@fortawesome/fontawesome-svg-core";
17
- import * as i21 from "@angular/common";
18
- import * as i23 from "@posiwise/core-guards";
19
- import * as i24 from "@posiwise/core-transloco";
20
- import * as i25 from "@posiwise/app-loader";
21
- import * as i27 from "@fortawesome/angular-fontawesome";
22
- import * as i28 from "primeng/iconfield";
23
- import * as i29 from "primeng/inputicon";
24
- import * as i30 from "primeng/autocomplete";
25
- import * as i31 from "primeng/inputtext";
26
- import * as i32 from "rete-angular-plugin/22";
17
+ import * as i28 from "@angular/common";
18
+ import * as i30 from "@posiwise/core-guards";
19
+ import * as i31 from "@posiwise/core-transloco";
20
+ import * as i32 from "@posiwise/app-loader";
21
+ import * as i34 from "@posiwise/directives";
22
+ import * as i35 from "@posiwise/pipes";
23
+ import * as i36 from "@fortawesome/angular-fontawesome";
24
+ import * as i37 from "primeng/iconfield";
25
+ import * as i38 from "primeng/inputicon";
26
+ import * as i39 from "primeng/autocomplete";
27
+ import * as i40 from "primeng/inputtext";
28
+ import * as i41 from "rete-angular-plugin/22";
27
29
  declare namespace flows_private_routing_module_d_exports {
28
30
  export { FlowsPrivateRoutingModule };
29
31
  }
@@ -90,11 +92,28 @@ declare function flowWorkflowForm(): UntypedFormGroup;
90
92
  declare function flowVersionBadgeClass(version: Pick<FlowVersion, 'published_at'>): string;
91
93
  declare function flowWorkflowBadgeClass(status: FlowWorkflowStatus): string;
92
94
  declare function flowVersionEditorTitleKey(version: FlowVersion | null, duplicateOf?: FlowVersion | null): string;
95
+ /** One finding of FlowGraphCheck on the server; `code` is stable, `message` is the English fallback. */
96
+ interface FlowGraphIssue {
97
+ code: string;
98
+ message: string;
99
+ /** Null for a problem with the graph as a whole. */
100
+ node_id: string | null;
101
+ /** The param it is about, when there is one. */
102
+ field?: string | null;
103
+ }
104
+ interface FlowGraphCheck {
105
+ /** False when publishing would be refused. */
106
+ valid: boolean;
107
+ errors: FlowGraphIssue[];
108
+ /** Allowed by publishing, but most likely not meant. */
109
+ warnings: FlowGraphIssue[];
110
+ }
93
111
  declare class FlowsWorkflowService {
94
112
  private readonly api;
95
113
  constructor(api: ProductsHttpService);
96
114
  getWorkflows(subscriptionId: number, status: FlowWorkflowStatus | null, paging?: Paging): Observable<FlowWorkflowListResponse>;
97
115
  getWorkflow(id: number, subscriptionId: number): Observable<FlowWorkflow>;
116
+ getVersion(id: number, subscriptionId: number): Observable<FlowVersion>;
98
117
  createWorkflow(subscriptionId: number, attrs: FlowWorkflowAttrs): Observable<FlowWorkflow>;
99
118
  updateWorkflow(id: number, subscriptionId: number, attrs: FlowWorkflowAttrs): Observable<FlowWorkflow>;
100
119
  /** 433 when the workflow has runs. subscription_id is a query param, not a body. */
@@ -103,8 +122,12 @@ declare class FlowsWorkflowService {
103
122
  createVersion(workflowId: number, subscriptionId: number, graph: unknown): Observable<FlowVersion>;
104
123
  /** Refused with 433 once the version is published. */
105
124
  updateVersion(id: number, subscriptionId: number, graph: unknown): Observable<FlowVersion>;
125
+ /** What publishing would refuse, for a graph saved or not. Writes nothing. */
126
+ checkGraph(workflowId: number, subscriptionId: number, graph: unknown): Observable<FlowGraphCheck>;
106
127
  /** Subscription admin only. Re-publishing is a server-side no-op. */
107
128
  publishVersion(id: number, subscriptionId: number): Observable<FlowVersion>;
129
+ /** Publishes the version only if it passes the check; otherwise returns the check and writes nothing. */
130
+ publishChecked(workflowId: number, version: FlowVersion, subscriptionId: number): Observable<FlowVersion | FlowGraphCheck>;
108
131
  static ɵfac: i0.ɵɵFactoryDeclaration<FlowsWorkflowService, never>;
109
132
  static ɵprov: i0.ɵɵInjectableDeclaration<any>;
110
133
  }
@@ -136,7 +159,6 @@ declare class FlowsWorkflowsComponent extends AppBaseComponent implements OnInit
136
159
  readonly create: import("@fortawesome/fontawesome-common-types").IconDefinition;
137
160
  readonly edit: import("@fortawesome/fontawesome-common-types").IconDefinition;
138
161
  readonly delete: import("@fortawesome/fontawesome-common-types").IconDefinition;
139
- readonly versions: import("@fortawesome/fontawesome-common-types").IconDefinition;
140
162
  readonly search: import("@fortawesome/fontawesome-common-types").IconDefinition;
141
163
  readonly publish: import("@fortawesome/fontawesome-common-types").IconDefinition;
142
164
  readonly duplicate: import("@fortawesome/fontawesome-common-types").IconDefinition;
@@ -144,6 +166,8 @@ declare class FlowsWorkflowsComponent extends AppBaseComponent implements OnInit
144
166
  readonly diagram: import("@fortawesome/fontawesome-common-types").IconDefinition;
145
167
  readonly json: import("@fortawesome/fontawesome-common-types").IconDefinition;
146
168
  readonly warning: import("@fortawesome/fontawesome-common-types").IconDefinition;
169
+ readonly collapsed: import("@fortawesome/fontawesome-common-types").IconDefinition;
170
+ readonly expanded: import("@fortawesome/fontawesome-common-types").IconDefinition;
147
171
  };
148
172
  readonly badgeClass: typeof flowWorkflowBadgeClass;
149
173
  constructor(injector: Injector, workflowService: FlowsWorkflowService, confirmDialog: ConfirmDialogService, cdr: ChangeDetectorRef);
@@ -153,7 +177,7 @@ declare class FlowsWorkflowsComponent extends AppBaseComponent implements OnInit
153
177
  filterByStatus(status: FlowWorkflowStatus | null): void;
154
178
  createWorkflow(): void;
155
179
  editWorkflow(workflow: FlowWorkflow): void;
156
- openVersions(workflow: FlowWorkflow): void;
180
+ openBuilder(workflow: FlowWorkflow): void;
157
181
  /** The server refuses with 433 when the workflow has runs. */
158
182
  deleteWorkflow(workflow: FlowWorkflow): void;
159
183
  private load;
@@ -185,7 +209,6 @@ declare class FlowsWorkflowFormComponent extends AppBaseComponent implements OnI
185
209
  readonly create: import("@fortawesome/fontawesome-common-types").IconDefinition;
186
210
  readonly edit: import("@fortawesome/fontawesome-common-types").IconDefinition;
187
211
  readonly delete: import("@fortawesome/fontawesome-common-types").IconDefinition;
188
- readonly versions: import("@fortawesome/fontawesome-common-types").IconDefinition;
189
212
  readonly search: import("@fortawesome/fontawesome-common-types").IconDefinition;
190
213
  readonly publish: import("@fortawesome/fontawesome-common-types").IconDefinition;
191
214
  readonly duplicate: import("@fortawesome/fontawesome-common-types").IconDefinition;
@@ -193,6 +216,8 @@ declare class FlowsWorkflowFormComponent extends AppBaseComponent implements OnI
193
216
  readonly diagram: import("@fortawesome/fontawesome-common-types").IconDefinition;
194
217
  readonly json: import("@fortawesome/fontawesome-common-types").IconDefinition;
195
218
  readonly warning: import("@fortawesome/fontawesome-common-types").IconDefinition;
219
+ readonly collapsed: import("@fortawesome/fontawesome-common-types").IconDefinition;
220
+ readonly expanded: import("@fortawesome/fontawesome-common-types").IconDefinition;
196
221
  };
197
222
  constructor(injector: Injector, workflowService: FlowsWorkflowService, cdr: ChangeDetectorRef);
198
223
  get isEdit(): boolean;
@@ -201,12 +226,32 @@ declare class FlowsWorkflowFormComponent extends AppBaseComponent implements OnI
201
226
  save(): void;
202
227
  /** Relative to the parent, since create and edit sit at different depths. */
203
228
  back(): void;
229
+ private leave;
204
230
  private loadStatusOptions;
205
231
  private loadWorkflow;
206
232
  private settle;
207
233
  static ɵfac: i0.ɵɵFactoryDeclaration<FlowsWorkflowFormComponent, never>;
208
234
  static ɵcmp: i0.ɵɵComponentDeclaration<FlowsWorkflowFormComponent, "pw-flows-workflow-form", never, {}, {}, never, never, false, never>;
209
235
  }
236
+ /**
237
+ * The version the builder opens on when the page loads, from a list ordered newest first:
238
+ * the one a link asked for, else the newest draft, else the newest. Null means a new one.
239
+ */
240
+ declare function flowVersionOnArrival(versions: readonly FlowVersion[], requestedId: number | null): FlowVersion | null;
241
+ /** What the version editor shows. Opening or closing it resets all of this together. */
242
+ declare class FlowVersionEditorState {
243
+ open: boolean;
244
+ /** Null when authoring a new version. */
245
+ version: FlowVersion | null;
246
+ /** The version a new one is being copied from. */
247
+ duplicateOf: FlowVersion | null;
248
+ /** Why publishing the open version was refused. */
249
+ check: FlowGraphCheck | null;
250
+ show(version: FlowVersion | null, duplicateOf?: FlowVersion | null, check?: FlowGraphCheck | null): void;
251
+ close(): void;
252
+ /** The editor shows the version it was given, so it gets the published one. */
253
+ published(version: FlowVersion): void;
254
+ }
210
255
  declare namespace flows_workflow_versions_component_d_exports {
211
256
  export { FlowsWorkflowVersionsComponent };
212
257
  }
@@ -214,22 +259,19 @@ declare class FlowsWorkflowVersionsComponent extends AppBaseComponent implements
214
259
  private readonly workflowService;
215
260
  private readonly cdr;
216
261
  private readonly destroy$;
262
+ private readonly status?;
217
263
  subscriptionId: number;
218
264
  workflowId: number;
219
265
  loading: boolean;
220
266
  publishing: boolean;
221
267
  notFound: boolean;
222
- workflowName: string;
268
+ workflow: FlowWorkflow | null;
223
269
  versions: FlowVersion[];
224
270
  /** Shown against versions.length so the 500-row cap stays visible. */
225
271
  totalRecords: number;
226
- editorOpen: boolean;
227
- /** Null when authoring a new version. */
228
- editorVersion: FlowVersion | null;
229
- /** The version a new one is being copied from. */
230
- editorDuplicateOf: FlowVersion | null;
231
- /** Set by a link from a run; opened once, on the first load. */
232
- private requestedVersionId;
272
+ readonly editor: FlowVersionEditorState;
273
+ /** The builder opens by itself once, on the first load of each workflow. */
274
+ private arrived;
233
275
  icons: {
234
276
  readonly inspect: import("@fortawesome/fontawesome-common-types").IconDefinition;
235
277
  readonly back: import("@fortawesome/fontawesome-common-types").IconDefinition;
@@ -237,7 +279,6 @@ declare class FlowsWorkflowVersionsComponent extends AppBaseComponent implements
237
279
  readonly create: import("@fortawesome/fontawesome-common-types").IconDefinition;
238
280
  readonly edit: import("@fortawesome/fontawesome-common-types").IconDefinition;
239
281
  readonly delete: import("@fortawesome/fontawesome-common-types").IconDefinition;
240
- readonly versions: import("@fortawesome/fontawesome-common-types").IconDefinition;
241
282
  readonly search: import("@fortawesome/fontawesome-common-types").IconDefinition;
242
283
  readonly publish: import("@fortawesome/fontawesome-common-types").IconDefinition;
243
284
  readonly duplicate: import("@fortawesome/fontawesome-common-types").IconDefinition;
@@ -245,6 +286,8 @@ declare class FlowsWorkflowVersionsComponent extends AppBaseComponent implements
245
286
  readonly diagram: import("@fortawesome/fontawesome-common-types").IconDefinition;
246
287
  readonly json: import("@fortawesome/fontawesome-common-types").IconDefinition;
247
288
  readonly warning: import("@fortawesome/fontawesome-common-types").IconDefinition;
289
+ readonly collapsed: import("@fortawesome/fontawesome-common-types").IconDefinition;
290
+ readonly expanded: import("@fortawesome/fontawesome-common-types").IconDefinition;
248
291
  };
249
292
  readonly isPublished: typeof isFlowVersionPublished;
250
293
  readonly badgeClass: typeof flowVersionBadgeClass;
@@ -255,17 +298,35 @@ declare class FlowsWorkflowVersionsComponent extends AppBaseComponent implements
255
298
  openEditor(version?: FlowVersion | null, duplicateOf?: FlowVersion | null): void;
256
299
  /** Opens an unsaved new version holding a copy of this one's graph. */
257
300
  duplicate(version: FlowVersion): void;
258
- closeEditor(): void;
259
301
  onVersionSaved(): void;
302
+ /** Checked first: a version that would be refused opens with its problems listed instead. */
260
303
  publish(version: FlowVersion): void;
304
+ private publishOutcome;
261
305
  back(): void;
262
306
  private loadWorkflow;
263
307
  private load;
264
- private openRequestedVersion;
308
+ private openOnArrival;
265
309
  private settle;
266
310
  static ɵfac: i0.ɵɵFactoryDeclaration<FlowsWorkflowVersionsComponent, never>;
267
311
  static ɵcmp: i0.ɵɵComponentDeclaration<FlowsWorkflowVersionsComponent, "pw-flows-workflow-versions", never, {}, {}, never, never, false, never>;
268
312
  }
313
+ /** The fields that reach a node from one connected node before it. */
314
+ interface FlowFieldSource {
315
+ nodeId: string;
316
+ type: string;
317
+ /** The catalogue label, for a type the builder has no translation for. */
318
+ label: string;
319
+ /** Each key once, however many items carried it. */
320
+ names: string[];
321
+ /** For each of those that is a list: the keys of its entries, each once. */
322
+ lists: Record<string, string[]>;
323
+ }
324
+ /**
325
+ * The fields reaching a node, grouped by the connected node each comes from,
326
+ * nearest first. Only connected nodes count: a node with nothing leading to it
327
+ * has no sources.
328
+ */
329
+ declare function flowFieldSources(graph: FlowGraph, nodeId: string, definitions: FlowNodeDefinition[], learned?: Record<string, FlowItemFields>): FlowFieldSource[];
269
330
  type FlowNodeCategory = 'trigger' | 'logic' | 'data' | 'action';
270
331
  declare const FLOW_NODE_CATEGORIES: readonly FlowNodeCategory[];
271
332
  /** An edge with no branch leaves through `next`. */
@@ -279,7 +340,7 @@ interface FlowParamDetail {
279
340
  options?: string[];
280
341
  required?: boolean;
281
342
  }
282
- /** Field names this subscription's runs saw a node return: of an item, and of the entries of each list in it. */
343
+ /** Field names of an item, and of the entries of each list in it. */
283
344
  interface FlowItemFields {
284
345
  names: string[];
285
346
  lists: Record<string, string[]>;
@@ -293,10 +354,14 @@ interface FlowNodeDefinition {
293
354
  params: string[];
294
355
  /** Keyed by param; set on nodes an integration supplies, empty on the engine's own. */
295
356
  param_details?: Record<string, FlowParamDetail>;
296
- /** Absent until the node has run for this subscription. */
357
+ /** The node hands on the items it was given. */
358
+ passes_items?: boolean;
359
+ /** What the node type declares an item leaving it holds, plus what this subscription's runs saw. */
297
360
  item_fields?: FlowItemFields;
298
361
  condition: boolean;
299
362
  outputs: string[];
363
+ /** Dropped by the product that declared it: kept for flows that use it, not offered for new ones. */
364
+ retired?: boolean;
300
365
  }
301
366
  interface FlowNodeListResponse {
302
367
  flow_nodes: FlowNodeDefinition[];
@@ -307,11 +372,18 @@ interface FlowGraphPosition {
307
372
  x: number;
308
373
  y: number;
309
374
  }
375
+ /** How often a failed action node runs again, and the first wait; the engine doubles it each time. */
376
+ interface FlowNodeRetry {
377
+ times: number;
378
+ wait_seconds: number;
379
+ }
380
+ declare const FLOW_RETRY_DEFAULT: FlowNodeRetry;
310
381
  interface FlowGraphNode {
311
382
  id: string;
312
383
  type: string;
313
384
  params?: Record<string, unknown>;
314
385
  condition?: Record<string, unknown>;
386
+ retry?: FlowNodeRetry;
315
387
  position?: FlowGraphPosition;
316
388
  }
317
389
  interface FlowGraphEdge {
@@ -328,6 +400,8 @@ interface FlowNodeSelection {
328
400
  fieldSuggestions: string[];
329
401
  /** The lists an item reaching the node can hold, for Split out to pick from. */
330
402
  listSuggestions: string[];
403
+ /** The same fields, by the connected node they come from; null when none can ever reach it. */
404
+ fieldSources: FlowFieldSource[] | null;
331
405
  }
332
406
  interface FlowGraph {
333
407
  nodes: FlowGraphNode[];
@@ -338,6 +412,27 @@ declare function toFlowGraph(value: unknown): FlowGraph;
338
412
  declare function nextFlowNodeId(nodes: readonly Pick<FlowGraphNode, 'id'>[]): string;
339
413
  declare function nextFlowEdgeId(edges: readonly FlowGraphEdge[]): string;
340
414
  declare function flowNodeLabelKey(type: string): string;
415
+ /** The node with its retry setting replaced, or removed when there is none. */
416
+ declare function flowNodeWithRetry(node: FlowGraphNode, retry?: FlowNodeRetry): FlowGraphNode;
417
+ /** The fields one node handed on the last time its workflow ran (FlowWorkflowFields on the server). */
418
+ interface FlowWorkflowFieldsRow {
419
+ node_id: string;
420
+ /** Versions reuse node ids, so these belong to an id of this type only. */
421
+ node_type: string | null;
422
+ item_fields: FlowItemFields;
423
+ }
424
+ interface FlowWorkflowFieldsResponse {
425
+ flow_workflow_fields: FlowWorkflowFieldsRow[];
426
+ }
427
+ interface FlowWorkflowFields {
428
+ /** Keyed by flowNodeFieldsKey(id, type). */
429
+ byNode: Record<string, FlowItemFields>;
430
+ /** False until the workflow has run once, which is why nothing is known yet. */
431
+ ran: boolean;
432
+ }
433
+ declare const NO_FLOW_WORKFLOW_FIELDS: FlowWorkflowFields;
434
+ declare function flowNodeFieldsKey(nodeId: string, type: string | null | undefined): string;
435
+ declare function toFlowWorkflowFields(rows: FlowWorkflowFieldsRow[] | undefined): FlowWorkflowFields;
341
436
  declare class FlowsNodeService {
342
437
  private readonly api;
343
438
  private readonly cache;
@@ -346,6 +441,89 @@ declare class FlowsNodeService {
346
441
  static ɵfac: i0.ɵɵFactoryDeclaration<FlowsNodeService, never>;
347
442
  static ɵprov: i0.ɵɵInjectableDeclaration<any>;
348
443
  }
444
+ type FlowRunStatus = 'running' | 'awaiting' | 'succeeded' | 'failed';
445
+ type FlowRunStepStatus = 'pending' | 'running' | 'awaiting' | 'succeeded' | 'failed' | 'skipped';
446
+ declare const FLOW_RUN_TERMINAL_STATUSES: readonly FlowRunStatus[];
447
+ declare const FLOW_RUN_STEP_SETTLED_STATUSES: readonly FlowRunStepStatus[];
448
+ interface FlowRun {
449
+ id: number;
450
+ flow_workflow_id: number;
451
+ flow_version_id: number;
452
+ flow_workflow_name?: string;
453
+ flow_version_number?: number;
454
+ status: FlowRunStatus;
455
+ trigger_payload: unknown;
456
+ error: string | null;
457
+ started_at: string | null;
458
+ finished_at: string | null;
459
+ created_at: string;
460
+ updated_at: string;
461
+ }
462
+ interface FlowRunStep {
463
+ id: number;
464
+ flow_run_id: number;
465
+ node_id: string;
466
+ status: FlowRunStepStatus;
467
+ input_items: unknown[] | null;
468
+ output_items: unknown[] | null;
469
+ error: string | null;
470
+ attempts: number;
471
+ awaiting_since: string | null;
472
+ /** Set while a failed step waits to run again. */
473
+ retry_at?: string | null;
474
+ started_at: string | null;
475
+ finished_at: string | null;
476
+ created_at: string;
477
+ updated_at: string;
478
+ }
479
+ interface FlowRunListResponse {
480
+ flow_runs: FlowRun[];
481
+ object_count: number;
482
+ unfiltered_count: number;
483
+ }
484
+ interface FlowRunStepListResponse {
485
+ flow_run_steps: FlowRunStep[];
486
+ object_count: number;
487
+ unfiltered_count: number;
488
+ }
489
+ interface FlowRunQuery {
490
+ status?: FlowRunStatus;
491
+ flow_workflow_id?: number;
492
+ flow_version_id?: number;
493
+ }
494
+ declare function isFlowRunTerminal(run: Pick<FlowRun, 'status'>): boolean;
495
+ declare function isFlowRunStepSettled(step: Pick<FlowRunStep, 'status'>): boolean;
496
+ declare const FLOW_RUN_STATUS_ORDER: readonly FlowRunStatus[];
497
+ declare const FLOW_RUN_STATUS_KEYS: readonly string[];
498
+ declare function elapsedMs(from: string | null, to: string | null): number | null;
499
+ declare function flowRunBadgeClass(status: FlowRunStatus): string;
500
+ declare function flowRunStepBadgeClass(status: FlowRunStepStatus): string;
501
+ /** The time slot a scheduled run was for, from its trigger payload; null for any other run. */
502
+ declare function flowRunScheduledFor(run: FlowRun | undefined): string | null;
503
+ interface FlowRunDetail {
504
+ run: FlowRun;
505
+ steps: FlowRunStepListResponse;
506
+ }
507
+ /**
508
+ * Polls because the engine emits no run-lifecycle events yet; Part H swaps in
509
+ * a push here without any component changing.
510
+ */
511
+ declare class FlowsRunService {
512
+ private readonly api;
513
+ RUNS_PATH: string;
514
+ constructor(api: ProductsHttpService);
515
+ getRuns(subscriptionId: number, query?: FlowRunQuery, paging?: Paging): Observable<FlowRunListResponse>;
516
+ getRun(id: number, subscriptionId: number): Observable<FlowRun>;
517
+ getRunSteps(runId: number, subscriptionId: number, paging?: Paging): Observable<FlowRunStepListResponse>;
518
+ watchRuns(subscriptionId: number, query?: FlowRunQuery, paging?: Paging): Observable<FlowRunListResponse>;
519
+ watchRun(id: number, subscriptionId: number, paging?: Paging): Observable<FlowRunDetail>;
520
+ private hasUnsettledRun;
521
+ /** A help for the builder, so a failed load leaves it as it was before the flow ran. */
522
+ getWorkflowFields(workflowId: number, subscriptionId: number): Observable<FlowWorkflowFields>;
523
+ private definedQuery;
524
+ static ɵfac: i0.ɵɵFactoryDeclaration<FlowsRunService, never>;
525
+ static ɵprov: i0.ɵɵInjectableDeclaration<any>;
526
+ }
349
527
  declare namespace flows_version_editor_component_d_exports {
350
528
  export { FlowsVersionEditorComponent };
351
529
  }
@@ -353,6 +531,7 @@ type EditorView = 'canvas' | 'json';
353
531
  declare class FlowsVersionEditorComponent implements OnInit, OnChanges, OnDestroy {
354
532
  private readonly workflowService;
355
533
  private readonly nodeService;
534
+ private readonly runService;
356
535
  private readonly cdr;
357
536
  private readonly destroy$;
358
537
  /** Null when authoring a new version. */
@@ -361,6 +540,8 @@ declare class FlowsVersionEditorComponent implements OnInit, OnChanges, OnDestro
361
540
  duplicateOf: FlowVersion | null;
362
541
  workflowId: number;
363
542
  subscriptionId: number;
543
+ /** Why publishing this version was refused, when that is why it is open. */
544
+ check: FlowGraphCheck | null;
364
545
  readonly saved: EventEmitter<void>;
365
546
  readonly cancelled: EventEmitter<void>;
366
547
  private readonly canvas?;
@@ -371,7 +552,6 @@ declare class FlowsVersionEditorComponent implements OnInit, OnChanges, OnDestro
371
552
  readonly create: import("@fortawesome/fontawesome-common-types").IconDefinition;
372
553
  readonly edit: import("@fortawesome/fontawesome-common-types").IconDefinition;
373
554
  readonly delete: import("@fortawesome/fontawesome-common-types").IconDefinition;
374
- readonly versions: import("@fortawesome/fontawesome-common-types").IconDefinition;
375
555
  readonly search: import("@fortawesome/fontawesome-common-types").IconDefinition;
376
556
  readonly publish: import("@fortawesome/fontawesome-common-types").IconDefinition;
377
557
  readonly duplicate: import("@fortawesome/fontawesome-common-types").IconDefinition;
@@ -379,8 +559,12 @@ declare class FlowsVersionEditorComponent implements OnInit, OnChanges, OnDestro
379
559
  readonly diagram: import("@fortawesome/fontawesome-common-types").IconDefinition;
380
560
  readonly json: import("@fortawesome/fontawesome-common-types").IconDefinition;
381
561
  readonly warning: import("@fortawesome/fontawesome-common-types").IconDefinition;
562
+ readonly collapsed: import("@fortawesome/fontawesome-common-types").IconDefinition;
563
+ readonly expanded: import("@fortawesome/fontawesome-common-types").IconDefinition;
382
564
  };
383
565
  definitions: FlowNodeDefinition[];
566
+ /** The fields each node handed on the last time the workflow ran. */
567
+ workflowFields$?: Observable<FlowWorkflowFields>;
384
568
  loading: boolean;
385
569
  loadFailed: boolean;
386
570
  graph: FlowGraph;
@@ -389,7 +573,7 @@ declare class FlowsVersionEditorComponent implements OnInit, OnChanges, OnDestro
389
573
  selection: FlowNodeSelection | null;
390
574
  dropped: FlowGraphEdge[];
391
575
  saving: boolean;
392
- constructor(workflowService: FlowsWorkflowService, nodeService: FlowsNodeService, cdr: ChangeDetectorRef);
576
+ constructor(workflowService: FlowsWorkflowService, nodeService: FlowsNodeService, runService: FlowsRunService, cdr: ChangeDetectorRef);
393
577
  get readOnly(): boolean;
394
578
  get headingKey(): string;
395
579
  ngOnInit(): void;
@@ -419,87 +603,136 @@ declare class FlowsVersionEditorComponent implements OnInit, OnChanges, OnDestro
419
603
  "alias": "subscriptionId";
420
604
  "required": false;
421
605
  };
606
+ "check": {
607
+ "alias": "check";
608
+ "required": false;
609
+ };
422
610
  }, {
423
611
  "saved": "saved";
424
612
  "cancelled": "cancelled";
425
613
  }, never, never, false, never>;
426
614
  }
427
- type FlowRunStatus = 'running' | 'awaiting' | 'succeeded' | 'failed';
428
- type FlowRunStepStatus = 'pending' | 'running' | 'awaiting' | 'succeeded' | 'failed' | 'skipped';
429
- declare const FLOW_RUN_TERMINAL_STATUSES: readonly FlowRunStatus[];
430
- declare const FLOW_RUN_STEP_SETTLED_STATUSES: readonly FlowRunStepStatus[];
431
- interface FlowRun {
432
- id: number;
433
- flow_workflow_id: number;
434
- flow_version_id: number;
435
- flow_workflow_name?: string;
436
- flow_version_number?: number;
437
- status: FlowRunStatus;
438
- trigger_payload: unknown;
439
- error: string | null;
440
- started_at: string | null;
441
- finished_at: string | null;
442
- created_at: string;
443
- updated_at: string;
444
- }
445
- interface FlowRunStep {
446
- id: number;
447
- flow_run_id: number;
448
- node_id: string;
449
- status: FlowRunStepStatus;
450
- input_items: unknown[] | null;
451
- output_items: unknown[] | null;
452
- error: string | null;
453
- attempts: number;
454
- awaiting_since: string | null;
455
- started_at: string | null;
456
- finished_at: string | null;
457
- created_at: string;
458
- updated_at: string;
459
- }
460
- interface FlowRunListResponse {
461
- flow_runs: FlowRun[];
462
- object_count: number;
463
- unfiltered_count: number;
615
+ declare namespace flows_graph_canvas_component_d_exports {
616
+ export { FlowsGraphCanvasComponent };
464
617
  }
465
- interface FlowRunStepListResponse {
466
- flow_run_steps: FlowRunStep[];
467
- object_count: number;
468
- unfiltered_count: number;
618
+ declare class FlowsGraphCanvasComponent implements AfterViewInit, OnChanges, OnDestroy {
619
+ private readonly injector;
620
+ private readonly cdr;
621
+ graph: FlowGraph;
622
+ definitions: FlowNodeDefinition[];
623
+ /** The fields each node handed on in recent runs; null while loading. */
624
+ workflowFields: FlowWorkflowFields | null;
625
+ readOnly: boolean;
626
+ readonly selectionChange: EventEmitter<string>;
627
+ readonly graphChange: EventEmitter<void>;
628
+ /** Stored edges the canvas cannot draw, reported after every load. */
629
+ readonly dropped: EventEmitter<FlowGraphEdge[]>;
630
+ private readonly host;
631
+ drawFailed: boolean;
632
+ private editor?;
633
+ private selected;
634
+ private reselect?;
635
+ private pending;
636
+ constructor(injector: Injector, cdr: ChangeDetectorRef);
637
+ ngAfterViewInit(): void;
638
+ ngOnChanges(changes: SimpleChanges): void;
639
+ addNode(type: string): Promise<void>;
640
+ focusNode(nodeId: string): Promise<void>;
641
+ removeNode(nodeId: string): Promise<void>;
642
+ updateNode(nodeId: string, flowNode: FlowGraphNode): Promise<void>;
643
+ selection(nodeId: string): FlowNodeSelection | null;
644
+ toGraph(): FlowGraph;
645
+ zoomToFit(): Promise<void>;
646
+ ngOnDestroy(): void;
647
+ private reload;
648
+ private queue;
649
+ static ɵfac: i0.ɵɵFactoryDeclaration<FlowsGraphCanvasComponent, never>;
650
+ static ɵcmp: i0.ɵɵComponentDeclaration<FlowsGraphCanvasComponent, "pw-flows-graph-canvas", never, {
651
+ "graph": {
652
+ "alias": "graph";
653
+ "required": false;
654
+ };
655
+ "definitions": {
656
+ "alias": "definitions";
657
+ "required": false;
658
+ };
659
+ "workflowFields": {
660
+ "alias": "workflowFields";
661
+ "required": false;
662
+ };
663
+ "readOnly": {
664
+ "alias": "readOnly";
665
+ "required": false;
666
+ };
667
+ }, {
668
+ "selectionChange": "selectionChange";
669
+ "graphChange": "graphChange";
670
+ "dropped": "dropped";
671
+ }, never, never, false, never>;
469
672
  }
470
- interface FlowRunQuery {
471
- status?: FlowRunStatus;
472
- flow_workflow_id?: number;
473
- flow_version_id?: number;
673
+ declare namespace flows_graph_check_component_d_exports {
674
+ export { FlowGraphCheckRow, FlowsGraphCheckComponent };
474
675
  }
475
- declare function isFlowRunTerminal(run: Pick<FlowRun, 'status'>): boolean;
476
- declare function isFlowRunStepSettled(step: Pick<FlowRunStep, 'status'>): boolean;
477
- declare const FLOW_RUN_STATUS_ORDER: readonly FlowRunStatus[];
478
- declare const FLOW_RUN_STATUS_KEYS: readonly string[];
479
- declare function elapsedMs(from: string | null, to: string | null): number | null;
480
- declare function flowRunBadgeClass(status: FlowRunStatus): string;
481
- declare function flowRunStepBadgeClass(status: FlowRunStepStatus): string;
482
- interface FlowRunDetail {
483
- run: FlowRun;
484
- steps: FlowRunStepListResponse;
676
+ interface FlowGraphCheckRow {
677
+ issue: FlowGraphIssue;
678
+ severity: 'error' | 'warning';
679
+ place: string;
680
+ text: string;
485
681
  }
486
682
  /**
487
- * Polls because the engine emits no run-lifecycle events yet; Part H swaps in
488
- * a push here without any component changing.
683
+ * Why publishing a version was refused, and a way to each problem: the node is
684
+ * selected and the cursor put in the field.
489
685
  */
490
- declare class FlowsRunService {
491
- private readonly api;
492
- RUNS_PATH: string;
493
- constructor(api: ProductsHttpService);
494
- getRuns(subscriptionId: number, query?: FlowRunQuery, paging?: Paging): Observable<FlowRunListResponse>;
495
- getRun(id: number, subscriptionId: number): Observable<FlowRun>;
496
- getRunSteps(runId: number, subscriptionId: number, paging?: Paging): Observable<FlowRunStepListResponse>;
497
- watchRuns(subscriptionId: number, query?: FlowRunQuery, paging?: Paging): Observable<FlowRunListResponse>;
498
- watchRun(id: number, subscriptionId: number, paging?: Paging): Observable<FlowRunDetail>;
499
- private hasUnsettledRun;
500
- private definedQuery;
501
- static ɵfac: i0.ɵɵFactoryDeclaration<FlowsRunService, never>;
502
- static ɵprov: i0.ɵɵInjectableDeclaration<any>;
686
+ declare class FlowsGraphCheckComponent implements OnChanges {
687
+ private readonly translation;
688
+ canvas: FlowsGraphCanvasComponent;
689
+ definitions: FlowNodeDefinition[];
690
+ /** The version as saved, which is what was checked. */
691
+ graph: FlowGraph | null;
692
+ result: FlowGraphCheck | null;
693
+ readonly icons: {
694
+ readonly inspect: import("@fortawesome/fontawesome-common-types").IconDefinition;
695
+ readonly back: import("@fortawesome/fontawesome-common-types").IconDefinition;
696
+ readonly error: import("@fortawesome/fontawesome-common-types").IconDefinition;
697
+ readonly create: import("@fortawesome/fontawesome-common-types").IconDefinition;
698
+ readonly edit: import("@fortawesome/fontawesome-common-types").IconDefinition;
699
+ readonly delete: import("@fortawesome/fontawesome-common-types").IconDefinition;
700
+ readonly search: import("@fortawesome/fontawesome-common-types").IconDefinition;
701
+ readonly publish: import("@fortawesome/fontawesome-common-types").IconDefinition;
702
+ readonly duplicate: import("@fortawesome/fontawesome-common-types").IconDefinition;
703
+ readonly fit: import("@fortawesome/fontawesome-common-types").IconDefinition;
704
+ readonly diagram: import("@fortawesome/fontawesome-common-types").IconDefinition;
705
+ readonly json: import("@fortawesome/fontawesome-common-types").IconDefinition;
706
+ readonly warning: import("@fortawesome/fontawesome-common-types").IconDefinition;
707
+ readonly collapsed: import("@fortawesome/fontawesome-common-types").IconDefinition;
708
+ readonly expanded: import("@fortawesome/fontawesome-common-types").IconDefinition;
709
+ };
710
+ rows: FlowGraphCheckRow[];
711
+ constructor(translation: TranslocoService);
712
+ ngOnChanges(): void;
713
+ goTo(issue: FlowGraphIssue): void;
714
+ /** Where it is, for the list: the node's name, or nothing for the graph as a whole. */
715
+ private place;
716
+ private describe;
717
+ static ɵfac: i0.ɵɵFactoryDeclaration<FlowsGraphCheckComponent, never>;
718
+ static ɵcmp: i0.ɵɵComponentDeclaration<FlowsGraphCheckComponent, "pw-flows-graph-check", never, {
719
+ "canvas": {
720
+ "alias": "canvas";
721
+ "required": true;
722
+ };
723
+ "definitions": {
724
+ "alias": "definitions";
725
+ "required": false;
726
+ };
727
+ "graph": {
728
+ "alias": "graph";
729
+ "required": false;
730
+ };
731
+ "result": {
732
+ "alias": "result";
733
+ "required": false;
734
+ };
735
+ }, {}, never, never, false, never>;
503
736
  }
504
737
  declare namespace flows_runs_component_d_exports {
505
738
  export { FlowsRunsComponent };
@@ -531,7 +764,6 @@ declare class FlowsRunsComponent extends AppBaseComponent implements OnInit {
531
764
  readonly create: import("@fortawesome/fontawesome-common-types").IconDefinition;
532
765
  readonly edit: import("@fortawesome/fontawesome-common-types").IconDefinition;
533
766
  readonly delete: import("@fortawesome/fontawesome-common-types").IconDefinition;
534
- readonly versions: import("@fortawesome/fontawesome-common-types").IconDefinition;
535
767
  readonly search: import("@fortawesome/fontawesome-common-types").IconDefinition;
536
768
  readonly publish: import("@fortawesome/fontawesome-common-types").IconDefinition;
537
769
  readonly duplicate: import("@fortawesome/fontawesome-common-types").IconDefinition;
@@ -539,6 +771,8 @@ declare class FlowsRunsComponent extends AppBaseComponent implements OnInit {
539
771
  readonly diagram: import("@fortawesome/fontawesome-common-types").IconDefinition;
540
772
  readonly json: import("@fortawesome/fontawesome-common-types").IconDefinition;
541
773
  readonly warning: import("@fortawesome/fontawesome-common-types").IconDefinition;
774
+ readonly collapsed: import("@fortawesome/fontawesome-common-types").IconDefinition;
775
+ readonly expanded: import("@fortawesome/fontawesome-common-types").IconDefinition;
542
776
  };
543
777
  constructor(injector: Injector, flowsRunService: FlowsRunService, cdr: ChangeDetectorRef);
544
778
  ngOnInit(): void;
@@ -688,6 +922,8 @@ declare namespace flows_run_inspector_component_d_exports {
688
922
  }
689
923
  declare class FlowsRunInspectorComponent extends AppBaseComponent implements OnInit {
690
924
  private readonly flowsRunService;
925
+ private readonly workflowService;
926
+ private readonly nodeService;
691
927
  private readonly cdr;
692
928
  private readonly destroy$;
693
929
  private watch$?;
@@ -703,7 +939,6 @@ declare class FlowsRunInspectorComponent extends AppBaseComponent implements OnI
703
939
  readonly create: import("@fortawesome/fontawesome-common-types").IconDefinition;
704
940
  readonly edit: import("@fortawesome/fontawesome-common-types").IconDefinition;
705
941
  readonly delete: import("@fortawesome/fontawesome-common-types").IconDefinition;
706
- readonly versions: import("@fortawesome/fontawesome-common-types").IconDefinition;
707
942
  readonly search: import("@fortawesome/fontawesome-common-types").IconDefinition;
708
943
  readonly publish: import("@fortawesome/fontawesome-common-types").IconDefinition;
709
944
  readonly duplicate: import("@fortawesome/fontawesome-common-types").IconDefinition;
@@ -711,72 +946,129 @@ declare class FlowsRunInspectorComponent extends AppBaseComponent implements OnI
711
946
  readonly diagram: import("@fortawesome/fontawesome-common-types").IconDefinition;
712
947
  readonly json: import("@fortawesome/fontawesome-common-types").IconDefinition;
713
948
  readonly warning: import("@fortawesome/fontawesome-common-types").IconDefinition;
949
+ readonly collapsed: import("@fortawesome/fontawesome-common-types").IconDefinition;
950
+ readonly expanded: import("@fortawesome/fontawesome-common-types").IconDefinition;
714
951
  };
715
952
  readonly openSteps: Set<number>;
716
953
  readonly trackByStep: (_: number, step: FlowRunStep) => number;
717
- constructor(injector: Injector, flowsRunService: FlowsRunService, cdr: ChangeDetectorRef);
954
+ readonly labelKey: typeof flowNodeLabelKey;
955
+ readonly scheduledFor: typeof flowRunScheduledFor;
956
+ /** Node id to type, from the run's version: a step names its node by id only. */
957
+ nodeTypes: Record<string, string>;
958
+ nodeIds: string[];
959
+ definitions: Record<string, FlowNodeDefinition>;
960
+ private namedVersionId?;
961
+ constructor(injector: Injector, flowsRunService: FlowsRunService, workflowService: FlowsWorkflowService, nodeService: FlowsNodeService, cdr: ChangeDetectorRef);
718
962
  ngOnInit(): void;
719
963
  ngOnDestroy(): void;
720
964
  back(): void;
721
965
  runBadgeClass(status: FlowRunStatus): string;
722
966
  stepBadgeClass(status: FlowRunStepStatus): string;
723
967
  elapsed(from: string | null, to: string | null): number | null;
724
- onStepToggle(stepId: number, event: Event): void;
968
+ toggleItems(stepId: number): void;
725
969
  asJson(value: unknown): string;
726
970
  private watch;
971
+ private nameNodes;
727
972
  private fail;
728
973
  private settle;
729
974
  static ɵfac: i0.ɵɵFactoryDeclaration<FlowsRunInspectorComponent, never>;
730
975
  static ɵcmp: i0.ɵɵComponentDeclaration<FlowsRunInspectorComponent, "pw-flows-run-inspector", never, {}, {}, never, never, false, never>;
731
976
  }
732
- declare namespace flows_graph_canvas_component_d_exports {
733
- export { FlowsGraphCanvasComponent };
734
- }
735
- declare class FlowsGraphCanvasComponent implements AfterViewInit, OnChanges, OnDestroy {
736
- private readonly injector;
977
+ declare namespace flows_run_progress_component_d_exports {
978
+ export { FlowRunProgress, FlowsRunProgressComponent, flowRunProgress };
979
+ }
980
+ interface FlowRunProgress {
981
+ done: number;
982
+ failed: number;
983
+ skipped: number;
984
+ /** Succeeded, failed or skipped. */
985
+ settled: number;
986
+ running: number;
987
+ /** Nodes of the version with no step yet; "not run" once the run has ended. */
988
+ waiting: number;
989
+ total: number;
990
+ percent: number;
991
+ }
992
+ /** Counted against the version's nodes, so a branch that is never taken still ends at 100%. */
993
+ declare function flowRunProgress(steps: FlowRunStep[], nodeIds: string[]): FlowRunProgress;
994
+ declare class FlowsRunProgressComponent implements OnChanges, OnDestroy {
737
995
  private readonly cdr;
738
- graph: FlowGraph;
739
- definitions: FlowNodeDefinition[];
740
- readOnly: boolean;
741
- readonly selectionChange: EventEmitter<string>;
742
- readonly graphChange: EventEmitter<void>;
743
- /** Stored edges the canvas cannot draw, reported after every load. */
744
- readonly dropped: EventEmitter<FlowGraphEdge[]>;
745
- private readonly host;
746
- drawFailed: boolean;
747
- private editor?;
748
- private pending;
749
- constructor(injector: Injector, cdr: ChangeDetectorRef);
750
- ngAfterViewInit(): void;
751
- ngOnChanges(changes: SimpleChanges): void;
752
- addNode(type: string): Promise<void>;
753
- removeNode(nodeId: string): Promise<void>;
754
- updateNode(nodeId: string, flowNode: FlowGraphNode): Promise<void>;
755
- selection(nodeId: string): FlowNodeSelection | null;
756
- toGraph(): FlowGraph;
757
- zoomToFit(): Promise<void>;
996
+ run: FlowRun;
997
+ steps: FlowRunStep[];
998
+ /** Empty until the version is loaded; the steps alone are counted until then. */
999
+ nodeIds: string[];
1000
+ progress: FlowRunProgress;
1001
+ elapsed: number | null;
1002
+ private tick$?;
1003
+ constructor(cdr: ChangeDetectorRef);
1004
+ get ended(): boolean;
1005
+ ngOnChanges(): void;
758
1006
  ngOnDestroy(): void;
759
- private reload;
760
- private queue;
761
- static ɵfac: i0.ɵɵFactoryDeclaration<FlowsGraphCanvasComponent, never>;
762
- static ɵcmp: i0.ɵɵComponentDeclaration<FlowsGraphCanvasComponent, "pw-flows-graph-canvas", never, {
763
- "graph": {
764
- "alias": "graph";
1007
+ private updateElapsed;
1008
+ static ɵfac: i0.ɵɵFactoryDeclaration<FlowsRunProgressComponent, never>;
1009
+ static ɵcmp: i0.ɵɵComponentDeclaration<FlowsRunProgressComponent, "pw-flows-run-progress", never, {
1010
+ "run": {
1011
+ "alias": "run";
1012
+ "required": true;
1013
+ };
1014
+ "steps": {
1015
+ "alias": "steps";
765
1016
  "required": false;
766
1017
  };
767
- "definitions": {
768
- "alias": "definitions";
1018
+ "nodeIds": {
1019
+ "alias": "nodeIds";
769
1020
  "required": false;
770
1021
  };
771
- "readOnly": {
772
- "alias": "readOnly";
1022
+ }, {}, never, never, false, never>;
1023
+ }
1024
+ /** A step error in words the person running the flow can act on: a translation key and its values. */
1025
+ interface FlowStepErrorText {
1026
+ key: string;
1027
+ params: Record<string, string>;
1028
+ }
1029
+ /** Null for an empty error. An unknown error keeps its own words, so nothing is hidden. */
1030
+ declare function flowStepErrorText(error: string | null | undefined): FlowStepErrorText | null;
1031
+ declare namespace flows_step_error_component_d_exports {
1032
+ export { FlowsStepErrorComponent };
1033
+ }
1034
+ /**
1035
+ * Why a step failed, in plain words under its status: red once it has failed,
1036
+ * amber while it will still try again. The icon keeps the raw message.
1037
+ */
1038
+ declare class FlowsStepErrorComponent implements OnChanges {
1039
+ error: string | null;
1040
+ /** The step will run again, so the error is the last try's, not the outcome. */
1041
+ retrying: boolean;
1042
+ readonly icons: {
1043
+ readonly inspect: import("@fortawesome/fontawesome-common-types").IconDefinition;
1044
+ readonly back: import("@fortawesome/fontawesome-common-types").IconDefinition;
1045
+ readonly error: import("@fortawesome/fontawesome-common-types").IconDefinition;
1046
+ readonly create: import("@fortawesome/fontawesome-common-types").IconDefinition;
1047
+ readonly edit: import("@fortawesome/fontawesome-common-types").IconDefinition;
1048
+ readonly delete: import("@fortawesome/fontawesome-common-types").IconDefinition;
1049
+ readonly search: import("@fortawesome/fontawesome-common-types").IconDefinition;
1050
+ readonly publish: import("@fortawesome/fontawesome-common-types").IconDefinition;
1051
+ readonly duplicate: import("@fortawesome/fontawesome-common-types").IconDefinition;
1052
+ readonly fit: import("@fortawesome/fontawesome-common-types").IconDefinition;
1053
+ readonly diagram: import("@fortawesome/fontawesome-common-types").IconDefinition;
1054
+ readonly json: import("@fortawesome/fontawesome-common-types").IconDefinition;
1055
+ readonly warning: import("@fortawesome/fontawesome-common-types").IconDefinition;
1056
+ readonly collapsed: import("@fortawesome/fontawesome-common-types").IconDefinition;
1057
+ readonly expanded: import("@fortawesome/fontawesome-common-types").IconDefinition;
1058
+ };
1059
+ text: FlowStepErrorText | null;
1060
+ ngOnChanges(): void;
1061
+ static ɵfac: i0.ɵɵFactoryDeclaration<FlowsStepErrorComponent, never>;
1062
+ static ɵcmp: i0.ɵɵComponentDeclaration<FlowsStepErrorComponent, "pw-flows-step-error", never, {
1063
+ "error": {
1064
+ "alias": "error";
773
1065
  "required": false;
774
1066
  };
775
- }, {
776
- "selectionChange": "selectionChange";
777
- "graphChange": "graphChange";
778
- "dropped": "dropped";
779
- }, never, never, false, never>;
1067
+ "retrying": {
1068
+ "alias": "retrying";
1069
+ "required": false;
1070
+ };
1071
+ }, {}, never, never, false, never>;
780
1072
  }
781
1073
  declare const FLOW_INPUT = "in";
782
1074
  declare class FlowCanvasNode extends ClassicPreset.Node {
@@ -920,10 +1212,10 @@ declare class FlowsNodePaletteComponent implements OnChanges {
920
1212
  "add": "add";
921
1213
  }, never, never, false, never>;
922
1214
  }
923
- type FlowFieldKind = 'text' | 'textarea' | 'email' | 'member' | 'members' | 'json' | 'pairs' | 'mode' | 'cron' | 'timezone' | 'number' | 'select' | 'list';
1215
+ type FlowFieldKind$1 = 'text' | 'textarea' | 'email' | 'member' | 'members' | 'json' | 'pairs' | 'mode' | 'cron' | 'timezone' | 'number' | 'select' | 'list';
924
1216
  interface FlowNodeField extends Omit<FlowParamDetail, 'kind'> {
925
1217
  key: string;
926
- kind: FlowFieldKind;
1218
+ kind: FlowFieldKind$1;
927
1219
  }
928
1220
  declare function flowNodeFields(definition: FlowNodeDefinition): FlowNodeField[];
929
1221
  /** A number, unless it is a {{placeholder}} that a run fills in. */
@@ -931,6 +1223,8 @@ declare function flowNumberValue(value: unknown): unknown;
931
1223
  /** data.merge accepts only this mode today. */
932
1224
  declare const FLOW_MERGE_MODES: readonly string[];
933
1225
  declare function flowParamLabelKey(key: string): string;
1226
+ /** Help for one field of one node type; a node type's own help from the catalogue wins. */
1227
+ declare function flowParamHelpKey(type: string, key: string): string;
934
1228
  declare namespace flows_node_inspector_component_d_exports {
935
1229
  export { FlowsNodeInspectorComponent };
936
1230
  }
@@ -944,6 +1238,10 @@ declare class FlowsNodeInspectorComponent implements OnChanges, AfterViewChecked
944
1238
  fieldSuggestions: string[];
945
1239
  /** The lists Split out can pick from; empty until the node before it has run. */
946
1240
  listSuggestions: string[];
1241
+ /** The same fields, by the connected node they come from; null hides the section. */
1242
+ fieldSources: FlowFieldSource[] | null;
1243
+ /** The workflow has not run yet, so no fields have been seen. */
1244
+ firstRun: boolean;
947
1245
  private leaving?;
948
1246
  readonly nodeChange: EventEmitter<FlowGraphNode>;
949
1247
  readonly remove: EventEmitter<void>;
@@ -954,7 +1252,6 @@ declare class FlowsNodeInspectorComponent implements OnChanges, AfterViewChecked
954
1252
  readonly create: import("@fortawesome/fontawesome-common-types").IconDefinition;
955
1253
  readonly edit: import("@fortawesome/fontawesome-common-types").IconDefinition;
956
1254
  readonly delete: import("@fortawesome/fontawesome-common-types").IconDefinition;
957
- readonly versions: import("@fortawesome/fontawesome-common-types").IconDefinition;
958
1255
  readonly search: import("@fortawesome/fontawesome-common-types").IconDefinition;
959
1256
  readonly publish: import("@fortawesome/fontawesome-common-types").IconDefinition;
960
1257
  readonly duplicate: import("@fortawesome/fontawesome-common-types").IconDefinition;
@@ -962,6 +1259,8 @@ declare class FlowsNodeInspectorComponent implements OnChanges, AfterViewChecked
962
1259
  readonly diagram: import("@fortawesome/fontawesome-common-types").IconDefinition;
963
1260
  readonly json: import("@fortawesome/fontawesome-common-types").IconDefinition;
964
1261
  readonly warning: import("@fortawesome/fontawesome-common-types").IconDefinition;
1262
+ readonly collapsed: import("@fortawesome/fontawesome-common-types").IconDefinition;
1263
+ readonly expanded: import("@fortawesome/fontawesome-common-types").IconDefinition;
965
1264
  };
966
1265
  mergeModes: {
967
1266
  value: string;
@@ -970,6 +1269,7 @@ declare class FlowsNodeInspectorComponent implements OnChanges, AfterViewChecked
970
1269
  readonly defaultMergeMode: string;
971
1270
  readonly labelKey: typeof flowNodeLabelKey;
972
1271
  readonly paramLabelKey: typeof flowParamLabelKey;
1272
+ readonly paramHelpKey: typeof flowParamHelpKey;
973
1273
  readonly numberValue: typeof flowNumberValue;
974
1274
  /** `id` names the node too, so each node gets its own inputs. */
975
1275
  fields: (FlowNodeField & {
@@ -985,6 +1285,7 @@ declare class FlowsNodeInspectorComponent implements OnChanges, AfterViewChecked
985
1285
  fieldId(key: string): string;
986
1286
  param(key: string): unknown;
987
1287
  setParam(key: string, value: unknown): void;
1288
+ setRetry(retry: FlowGraphNode['retry']): void;
988
1289
  setCondition(condition: unknown): void;
989
1290
  private emit;
990
1291
  static ɵfac: i0.ɵɵFactoryDeclaration<FlowsNodeInspectorComponent, never>;
@@ -1013,6 +1314,14 @@ declare class FlowsNodeInspectorComponent implements OnChanges, AfterViewChecked
1013
1314
  "alias": "listSuggestions";
1014
1315
  "required": false;
1015
1316
  };
1317
+ "fieldSources": {
1318
+ "alias": "fieldSources";
1319
+ "required": false;
1320
+ };
1321
+ "firstRun": {
1322
+ "alias": "firstRun";
1323
+ "required": false;
1324
+ };
1016
1325
  }, {
1017
1326
  "nodeChange": "nodeChange";
1018
1327
  "remove": "remove";
@@ -1091,7 +1400,6 @@ declare class FlowsConditionFieldComponent implements OnChanges {
1091
1400
  readonly create: import("@fortawesome/fontawesome-common-types").IconDefinition;
1092
1401
  readonly edit: import("@fortawesome/fontawesome-common-types").IconDefinition;
1093
1402
  readonly delete: import("@fortawesome/fontawesome-common-types").IconDefinition;
1094
- readonly versions: import("@fortawesome/fontawesome-common-types").IconDefinition;
1095
1403
  readonly search: import("@fortawesome/fontawesome-common-types").IconDefinition;
1096
1404
  readonly publish: import("@fortawesome/fontawesome-common-types").IconDefinition;
1097
1405
  readonly duplicate: import("@fortawesome/fontawesome-common-types").IconDefinition;
@@ -1099,6 +1407,8 @@ declare class FlowsConditionFieldComponent implements OnChanges {
1099
1407
  readonly diagram: import("@fortawesome/fontawesome-common-types").IconDefinition;
1100
1408
  readonly json: import("@fortawesome/fontawesome-common-types").IconDefinition;
1101
1409
  readonly warning: import("@fortawesome/fontawesome-common-types").IconDefinition;
1410
+ readonly collapsed: import("@fortawesome/fontawesome-common-types").IconDefinition;
1411
+ readonly expanded: import("@fortawesome/fontawesome-common-types").IconDefinition;
1102
1412
  };
1103
1413
  options: Record<string, ConditionOption[]>;
1104
1414
  readonly takesValue: typeof takesValue;
@@ -1162,7 +1472,6 @@ declare class FlowsPairsFieldComponent implements OnChanges {
1162
1472
  readonly create: import("@fortawesome/fontawesome-common-types").IconDefinition;
1163
1473
  readonly edit: import("@fortawesome/fontawesome-common-types").IconDefinition;
1164
1474
  readonly delete: import("@fortawesome/fontawesome-common-types").IconDefinition;
1165
- readonly versions: import("@fortawesome/fontawesome-common-types").IconDefinition;
1166
1475
  readonly search: import("@fortawesome/fontawesome-common-types").IconDefinition;
1167
1476
  readonly publish: import("@fortawesome/fontawesome-common-types").IconDefinition;
1168
1477
  readonly duplicate: import("@fortawesome/fontawesome-common-types").IconDefinition;
@@ -1170,6 +1479,8 @@ declare class FlowsPairsFieldComponent implements OnChanges {
1170
1479
  readonly diagram: import("@fortawesome/fontawesome-common-types").IconDefinition;
1171
1480
  readonly json: import("@fortawesome/fontawesome-common-types").IconDefinition;
1172
1481
  readonly warning: import("@fortawesome/fontawesome-common-types").IconDefinition;
1482
+ readonly collapsed: import("@fortawesome/fontawesome-common-types").IconDefinition;
1483
+ readonly expanded: import("@fortawesome/fontawesome-common-types").IconDefinition;
1173
1484
  };
1174
1485
  pairs: Pair[];
1175
1486
  private emitted;
@@ -1258,8 +1569,182 @@ declare class FlowsMemberFieldComponent implements OnChanges, OnDestroy {
1258
1569
  "valueChange": "valueChange";
1259
1570
  }, never, never, false, never>;
1260
1571
  }
1572
+ declare namespace flows_retry_field_component_d_exports {
1573
+ export { FlowsRetryFieldComponent };
1574
+ }
1575
+ /** Whether a failed action node runs again, how often, and how long it waits first. */
1576
+ declare class FlowsRetryFieldComponent {
1577
+ value: FlowNodeRetry | undefined;
1578
+ inputId: string;
1579
+ readOnly: boolean;
1580
+ readonly valueChange: EventEmitter<FlowNodeRetry>;
1581
+ toggle(on: boolean): void;
1582
+ /** Kept within what the engine accepts, so a typo cannot block publishing. */
1583
+ set(key: keyof FlowNodeRetry, text: string, max: number): void;
1584
+ static ɵfac: i0.ɵɵFactoryDeclaration<FlowsRetryFieldComponent, never>;
1585
+ static ɵcmp: i0.ɵɵComponentDeclaration<FlowsRetryFieldComponent, "pw-flows-retry-field", never, {
1586
+ "value": {
1587
+ "alias": "value";
1588
+ "required": false;
1589
+ };
1590
+ "inputId": {
1591
+ "alias": "inputId";
1592
+ "required": false;
1593
+ };
1594
+ "readOnly": {
1595
+ "alias": "readOnly";
1596
+ "required": false;
1597
+ };
1598
+ }, {
1599
+ "valueChange": "valueChange";
1600
+ }, never, never, false, never>;
1601
+ }
1602
+ declare namespace flows_available_fields_component_d_exports {
1603
+ export { FlowFieldKind, FlowsAvailableFieldsComponent };
1604
+ }
1605
+ /** What a field is: a value, a list, or one key of a list's entries. */
1606
+ type FlowFieldKind = 'value' | 'list' | 'entry';
1607
+ /**
1608
+ * The fields of the items reaching a node, under the connected node each comes
1609
+ * from. Picking one fills the box last used in the same node panel, or the only
1610
+ * box when there is one, the way that box takes it: a placeholder in text, a
1611
+ * plain name where a field is named. Fields that box cannot take are not shown.
1612
+ */
1613
+ declare class FlowsAvailableFieldsComponent {
1614
+ private readonly host;
1615
+ /** By the connected node each field comes from, nearest first. */
1616
+ sources: FlowFieldSource[];
1617
+ inputId: string;
1618
+ readOnly: boolean;
1619
+ firstRun: boolean;
1620
+ nodeType: string;
1621
+ readonly labelKey: typeof flowNodeLabelKey;
1622
+ query: string;
1623
+ /** The box a pick goes into takes a field's name rather than a placeholder. */
1624
+ names: boolean;
1625
+ private box?;
1626
+ constructor(host: ElementRef<HTMLElement>, cdr: ChangeDetectorRef);
1627
+ /** Counts only what the box can take, which is all that is shown. */
1628
+ get searchable(): boolean;
1629
+ remember(target: EventTarget | null): void;
1630
+ takesNames(): boolean;
1631
+ /** Whether anything of this source can go into the box. */
1632
+ offers(source: FlowFieldSource, names: boolean): boolean;
1633
+ matches(name: string): boolean;
1634
+ /** Split out splits a list; a field-name box takes no list entry. */
1635
+ fits(kind: FlowFieldKind, names: boolean): boolean;
1636
+ placeholder(field: string, names: boolean): string;
1637
+ /** `clients.*.id`: every entry's id, as a template reads a list. */
1638
+ entry(list: string, key: string): string;
1639
+ insert(field: string): void;
1640
+ /** The box last used, or the only one the panel has, so a node with one box needs no click into it. */
1641
+ private target;
1642
+ private onlyBox;
1643
+ static ɵfac: i0.ɵɵFactoryDeclaration<FlowsAvailableFieldsComponent, never>;
1644
+ static ɵcmp: i0.ɵɵComponentDeclaration<FlowsAvailableFieldsComponent, "pw-flows-available-fields", never, {
1645
+ "sources": {
1646
+ "alias": "sources";
1647
+ "required": false;
1648
+ };
1649
+ "inputId": {
1650
+ "alias": "inputId";
1651
+ "required": false;
1652
+ };
1653
+ "readOnly": {
1654
+ "alias": "readOnly";
1655
+ "required": false;
1656
+ };
1657
+ "firstRun": {
1658
+ "alias": "firstRun";
1659
+ "required": false;
1660
+ };
1661
+ "nodeType": {
1662
+ "alias": "nodeType";
1663
+ "required": false;
1664
+ };
1665
+ }, {}, never, never, false, never>;
1666
+ }
1667
+ declare namespace flows_unknown_fields_component_d_exports {
1668
+ export { FlowsUnknownFieldsComponent };
1669
+ }
1670
+ /** A warning, never a block: a field can come from a step whose output is not known yet. */
1671
+ declare class FlowsUnknownFieldsComponent implements OnChanges {
1672
+ value: unknown;
1673
+ /** The fields known to reach the node. */
1674
+ known: string[];
1675
+ readonly icons: {
1676
+ readonly inspect: import("@fortawesome/fontawesome-common-types").IconDefinition;
1677
+ readonly back: import("@fortawesome/fontawesome-common-types").IconDefinition;
1678
+ readonly error: import("@fortawesome/fontawesome-common-types").IconDefinition;
1679
+ readonly create: import("@fortawesome/fontawesome-common-types").IconDefinition;
1680
+ readonly edit: import("@fortawesome/fontawesome-common-types").IconDefinition;
1681
+ readonly delete: import("@fortawesome/fontawesome-common-types").IconDefinition;
1682
+ readonly search: import("@fortawesome/fontawesome-common-types").IconDefinition;
1683
+ readonly publish: import("@fortawesome/fontawesome-common-types").IconDefinition;
1684
+ readonly duplicate: import("@fortawesome/fontawesome-common-types").IconDefinition;
1685
+ readonly fit: import("@fortawesome/fontawesome-common-types").IconDefinition;
1686
+ readonly diagram: import("@fortawesome/fontawesome-common-types").IconDefinition;
1687
+ readonly json: import("@fortawesome/fontawesome-common-types").IconDefinition;
1688
+ readonly warning: import("@fortawesome/fontawesome-common-types").IconDefinition;
1689
+ readonly collapsed: import("@fortawesome/fontawesome-common-types").IconDefinition;
1690
+ readonly expanded: import("@fortawesome/fontawesome-common-types").IconDefinition;
1691
+ };
1692
+ unknown: string;
1693
+ ngOnChanges(): void;
1694
+ static ɵfac: i0.ɵɵFactoryDeclaration<FlowsUnknownFieldsComponent, never>;
1695
+ static ɵcmp: i0.ɵɵComponentDeclaration<FlowsUnknownFieldsComponent, "pw-flows-unknown-fields", never, {
1696
+ "value": {
1697
+ "alias": "value";
1698
+ "required": false;
1699
+ };
1700
+ "known": {
1701
+ "alias": "known";
1702
+ "required": false;
1703
+ };
1704
+ }, {}, never, never, false, never>;
1705
+ }
1706
+ declare namespace flows_workflow_status_component_d_exports {
1707
+ export { FlowsWorkflowStatusComponent };
1708
+ }
1709
+ /** Whether the workflow runs. Only an active workflow starts runs from its trigger. */
1710
+ declare class FlowsWorkflowStatusComponent {
1711
+ private readonly workflowService;
1712
+ private readonly confirmDialog;
1713
+ private readonly cdr;
1714
+ workflow: FlowWorkflow;
1715
+ subscriptionId: number;
1716
+ /** With nothing published, an active workflow would have nothing to run. */
1717
+ hasPublished: boolean;
1718
+ readonly workflowChange: EventEmitter<FlowWorkflow>;
1719
+ readonly badgeClass: typeof flowWorkflowBadgeClass;
1720
+ saving: boolean;
1721
+ constructor(workflowService: FlowsWorkflowService, confirmDialog: ConfirmDialogService, cdr: ChangeDetectorRef);
1722
+ get isOn(): boolean;
1723
+ toggle(): void;
1724
+ /** Asked right after a publish, so a new workflow goes live in one more click. */
1725
+ offerTurnOn(versionNumber: number): void;
1726
+ private confirm;
1727
+ private save;
1728
+ static ɵfac: i0.ɵɵFactoryDeclaration<FlowsWorkflowStatusComponent, never>;
1729
+ static ɵcmp: i0.ɵɵComponentDeclaration<FlowsWorkflowStatusComponent, "pw-flows-workflow-status", never, {
1730
+ "workflow": {
1731
+ "alias": "workflow";
1732
+ "required": false;
1733
+ };
1734
+ "subscriptionId": {
1735
+ "alias": "subscriptionId";
1736
+ "required": false;
1737
+ };
1738
+ "hasPublished": {
1739
+ "alias": "hasPublished";
1740
+ "required": false;
1741
+ };
1742
+ }, {
1743
+ "workflowChange": "workflowChange";
1744
+ }, never, never, false, never>;
1745
+ }
1261
1746
  export declare class FlowsPrivateModule {
1262
1747
  static ɵfac: i0.ɵɵFactoryDeclaration<FlowsPrivateModule, never>;
1263
- static ɵmod: i0.ɵɵNgModuleDeclaration<FlowsPrivateModule, [typeof FlowsTabsComponent, typeof FlowsWorkflowsComponent, typeof FlowsWorkflowFormComponent, typeof FlowsWorkflowVersionsComponent, typeof FlowsVersionEditorComponent, typeof FlowsRunsComponent, typeof FlowsRunsFiltersComponent, typeof FlowsCronFieldComponent, typeof FlowsTimezoneFieldComponent, typeof FlowsRunInspectorComponent, typeof FlowsGraphCanvasComponent, typeof FlowsCanvasNodeComponent, typeof FlowsCanvasSocketComponent, typeof FlowsCanvasConnectionComponent, typeof FlowsNodePaletteComponent, typeof FlowsNodeInspectorComponent, typeof FlowsJsonFieldComponent, typeof FlowsConditionFieldComponent, typeof FlowsPairsFieldComponent, typeof FlowsMemberFieldComponent], [typeof i21.CommonModule, typeof i22.FormsModule, typeof i22.ReactiveFormsModule, typeof i23.TrackDirtyFormDirective, typeof i24.CoreTranslocoModule, typeof i25.AppLoaderModule, typeof i26.SharedComponentsModule, typeof i27.FontAwesomeModule, typeof i28.IconFieldModule, typeof i29.InputIconModule, typeof i30.AutoCompleteModule, typeof i31.InputTextModule, typeof i32.ReteModule, typeof FlowsPrivateRoutingModule], never>;
1748
+ static ɵmod: i0.ɵɵNgModuleDeclaration<FlowsPrivateModule, [typeof FlowsTabsComponent, typeof FlowsWorkflowsComponent, typeof FlowsWorkflowFormComponent, typeof FlowsWorkflowVersionsComponent, typeof FlowsVersionEditorComponent, typeof FlowsGraphCheckComponent, typeof FlowsRunsComponent, typeof FlowsRunsFiltersComponent, typeof FlowsCronFieldComponent, typeof FlowsTimezoneFieldComponent, typeof FlowsRunInspectorComponent, typeof FlowsRunProgressComponent, typeof FlowsStepErrorComponent, typeof FlowsGraphCanvasComponent, typeof FlowsCanvasNodeComponent, typeof FlowsCanvasSocketComponent, typeof FlowsCanvasConnectionComponent, typeof FlowsNodePaletteComponent, typeof FlowsNodeInspectorComponent, typeof FlowsJsonFieldComponent, typeof FlowsConditionFieldComponent, typeof FlowsPairsFieldComponent, typeof FlowsMemberFieldComponent, typeof FlowsRetryFieldComponent, typeof FlowsAvailableFieldsComponent, typeof FlowsUnknownFieldsComponent, typeof FlowsWorkflowStatusComponent], [typeof i28.CommonModule, typeof i29.FormsModule, typeof i29.ReactiveFormsModule, typeof i30.TrackDirtyFormDirective, typeof i31.CoreTranslocoModule, typeof i32.AppLoaderModule, typeof i33.SharedComponentsModule, typeof i34.DirectivesModule, typeof i35.PipesModule, typeof i36.FontAwesomeModule, typeof i37.IconFieldModule, typeof i38.InputIconModule, typeof i39.AutoCompleteModule, typeof i40.InputTextModule, typeof i41.ReteModule, typeof FlowsPrivateRoutingModule], never>;
1264
1749
  static ɵinj: i0.ɵɵInjectorDeclaration<FlowsPrivateModule>;
1265
1750
  }