@wise/dynamic-flow-client 5.3.0 → 5.4.1-experimental-ede02d2

package/build/types/controller/FlowController.d.ts

@@ -0,0 +1,18 @@
+import { BackConfig } from '../domain/components/RootDomainComponent';
+import { GetErrorMessageFunctions } from '../domain/mappers/types';
+import { FeatureFlags } from '../domain/mappers/utils/FeatureFlags';
+import { OnValueChange, ScrollToTop } from '../domain/types';
+import { DynamicFlowCoreProps } from '../types';
+export type FlowControllerProps = Omit<DynamicFlowCoreProps, 'renderers' | 'features'> & {
+    backConfig: BackConfig;
+    features: FeatureFlags;
+    getErrorMessageFunctions: GetErrorMessageFunctions;
+    onChange: () => void;
+    onValueChange: OnValueChange;
+    scrollToTop: ScrollToTop;
+    onLink: (url: string) => boolean;
+};
+export declare const createFlowController: (props: FlowControllerProps) => {
+    rootComponent: import("../domain/components/RootDomainComponent").RootDomainComponent;
+    cancel: () => void;
+};

package/build/types/controller/executeRequest.d.ts

@@ -0,0 +1,39 @@
+import { ErrorResponseBody, Model, Request, Step } from '@wise/dynamic-flow-types/spec';
+import { AnalyticsEventDispatcher, LoggingEventDispatcher } from '../domain/features/events';
+import { RequestCache } from '../domain/prefetching/request-cache';
+import { Behavior } from '../domain/types';
+export type Command = {
+    type: 'complete';
+    result: Model;
+} | {
+    type: 'replace-step';
+    step: Step;
+    etag: string | null;
+} | {
+    type: 'error';
+    body?: {
+        analytics?: ErrorResponseBody['analytics'];
+        errors?: Step['errors'];
+    };
+    httpError?: {
+        message?: string;
+        statusCode?: number;
+    };
+} | {
+    type: 'refresh';
+    body: {
+        refreshUrl: string;
+        errors?: Step['errors'];
+    };
+} | {
+    type: 'behavior';
+    behavior: Behavior;
+};
+export declare const executeRequest: (props: {
+    exit?: boolean;
+    request: Request;
+    requestCache: RequestCache;
+    httpClient: typeof fetch;
+    trackEvent: AnalyticsEventDispatcher<string>;
+    logEvent: LoggingEventDispatcher;
+}) => Promise<Command>;

package/build/types/controller/executeSubmission.d.ts

@@ -0,0 +1,15 @@
+import type { Action, Model, Request } from '@wise/dynamic-flow-types/spec';
+import type { AnalyticsEventDispatcher, LoggingEventDispatcher } from '../domain/features/events';
+import { RequestCache } from '../domain/prefetching/request-cache';
+import { HttpClient } from '../types';
+import { Command } from './executeRequest';
+export declare const executeSubmission: (props: {
+    action: Action;
+    model: Model;
+    isInitial: boolean;
+    requestCache: RequestCache;
+    httpClient: HttpClient;
+    trackEvent: AnalyticsEventDispatcher<string>;
+    logEvent: LoggingEventDispatcher;
+}) => Promise<Command>;
+export declare const createRequestFromAction: (action: Action, model: Model) => Request;

package/build/types/controller/getRequestAbortController.d.ts

@@ -0,0 +1,4 @@
+export declare const getRequestAbortController: () => {
+    abortAndGetNewSignal(): AbortSignal;
+    abort(): void;
+};

package/build/types/{flow → controller}/getResponseType.d.ts

@@ -1,4 +1,4 @@
-declare const responseTypes: readonly ["step", "action", "exit", "modal"];
+declare const responseTypes: readonly ["step", "action", "exit", "modal", "subflow"];
 export type ResponseType = (typeof responseTypes)[number];
 /**
  * Returns either 'step', 'action', or 'exit' based on the response headers and body.

package/build/types/controller/getSafeHttpClient.d.ts

@@ -0,0 +1 @@
+export declare const getSafeHttpClient: (httpClient: typeof fetch) => (input: Parameters<typeof fetch>[0], init?: Parameters<typeof fetch>[1]) => Promise<Response | null>;

package/build/types/controller/getStepCounter.d.ts

@@ -0,0 +1,9 @@
+/**
+ * To ensure there are no uid collisions between consecutive steps, we use a
+ * counter that is appended to the step id. This means that even steps with the
+ * same structure and ids will not have the same component uids.
+ */
+export declare const getStepCounter: () => {
+    increment(): void;
+    readonly current: number;
+};

package/build/types/controller/handleErrorResponse.d.ts

@@ -0,0 +1,3 @@
+import { AnalyticsEventDispatcher } from '../domain/features/events';
+import { Command } from './executeRequest';
+export declare const handleErrorResponse: (response: Response, actionId: string | undefined, trackEvent: AnalyticsEventDispatcher) => Promise<Command>;

package/build/types/{flow → controller}/response-utils.d.ts

@@ -1,10 +1,11 @@
-import type { ActionResponseBody, ErrorResponseBody, JsonElement, ModalBehavior, Step } from '@wise/dynamic-flow-types/spec';
+import type { ActionResponseBody, ErrorResponseBody, JsonElement, ModalBehavior, Step, SubflowResponseBody } from '@wise/dynamic-flow-types/spec';
 export declare const assertResponseIsValid: (response: unknown) => void;
 export declare const parseResponseBodyAsJsonElement: (response: Response) => Promise<JsonElement>;
 export declare const parseResponseBodyAsText: (response: Response) => Promise<string | null>;
 export declare function isActionResponseBody(body: unknown): body is ActionResponseBody;
 export declare function assertActionResponseBody(body: unknown): asserts body is ActionResponseBody;
 export declare function assertModalResponseBody(body: unknown): asserts body is Omit<ModalBehavior, 'type'>;
+export declare function assertSubflowResponseBody(body: unknown): asserts body is SubflowResponseBody;
 export declare function isErrorResponseBody(body: unknown): body is ErrorResponseBody;
 export declare function assertErrorResponseBody(body: unknown): asserts body is ErrorResponseBody;
 export declare function assertStepResponseBody(body: unknown): asserts body is Step;

package/build/types/domain/components/BooleanInputComponent.d.ts

@@ -1,6 +1,6 @@
 import type { SchemaOnChange } from '../features/schema-on-change/getSchemaOnChange';
 import type { PerformValidationAsync } from '../features/validationAsync/getPerformValidationAsync';
-import type { BaseInputComponent, InlineAlert, OnPersistAsync, OnValueChange, RepeatableSummary, UpdateComponent, ValidationAsyncState, SupportingValues } from '../types';
+import type { BaseInputComponent, InlineAlert, OnComponentUpdate, OnPersistAsync, OnValueChange, RepeatableSummary, SupportingValues, ValidationAsyncState } from '../types';
 export type BooleanInputComponent = BaseInputComponent<boolean> & {
     type: 'boolean';
     kind: 'input';
@@ -16,4 +16,4 @@ export declare const createBooleanInputComponent: (booleanInputProps: Pick<Boole
     summariser: (value: boolean) => RepeatableSummary;
     onValueChange: OnValueChange;
     onPersistAsync: OnPersistAsync | undefined;
-}, updateComponent: UpdateComponent) => BooleanInputComponent;
+}, onComponentUpdate: OnComponentUpdate) => BooleanInputComponent;

package/build/types/domain/components/DateInputComponent.d.ts

@@ -1,7 +1,7 @@
 import type { SchemaOnChange } from '../features/schema-on-change/getSchemaOnChange';
 import type { IsInvalidCheck } from '../features/validation/value-checks';
 import type { PerformValidationAsync } from '../features/validationAsync/getPerformValidationAsync';
-import type { BaseInputComponent, OnPersistAsync, OnValueChange, RepeatableSummary, Suggestions, UpdateComponent, ValidationAsyncState } from '../types';
+import type { BaseInputComponent, OnComponentUpdate, OnPersistAsync, OnValueChange, RepeatableSummary, Suggestions, ValidationAsyncState } from '../types';
 export type DateInputComponent = BaseInputComponent<string | null> & {
     type: 'date';
     kind: 'input';
@@ -18,4 +18,4 @@ export declare const createDateInputComponent: (textInputProps: Pick<DateInputCo
     onValueChange: OnValueChange;
     onPersistAsync: OnPersistAsync | undefined;
     summariser: (value: string | null) => RepeatableSummary;
-}, updateComponent: UpdateComponent) => DateInputComponent;
+}, onComponentUpdate: OnComponentUpdate) => DateInputComponent;

package/build/types/domain/components/FormattedValueComponent.d.ts

@@ -1,6 +1,6 @@
 import { JsonElement } from '@wise/dynamic-flow-types/spec';
 import { SchemaOnChange } from '../features/schema-on-change/getSchemaOnChange';
-import type { BaseSchemaComponent, InlineAlert, LocalValue, RepeatableSummary, UpdateComponent } from '../types';
+import type { BaseSchemaComponent, InlineAlert, LocalValue, OnComponentUpdate, RepeatableSummary } from '../types';
 export type FormattedValueComponent = BaseSchemaComponent<JsonElement> & {
     type: 'formatted-value';
     kind: 'input';
@@ -13,4 +13,4 @@ export type FormattedValueComponent = BaseSchemaComponent<JsonElement> & {
 export declare const createFormattedValueComponent: (props: Pick<FormattedValueComponent, "uid" | "schemaId" | "analyticsId" | "alert" | "control" | "description" | "errors" | "format" | "help" | "hidden" | "media" | "title" | "tags" | "value"> & {
     summariser: (value: LocalValue | null) => RepeatableSummary;
     schemaOnChange: SchemaOnChange | undefined;
-}, updateComponent: UpdateComponent) => FormattedValueComponent;
+}, onComponentUpdate: OnComponentUpdate) => FormattedValueComponent;

package/build/types/domain/components/IntegerInputComponent.d.ts

@@ -1,7 +1,7 @@
 import type { SchemaOnChange } from '../features/schema-on-change/getSchemaOnChange';
 import type { IsInvalidCheck } from '../features/validation/value-checks';
 import type { PerformValidationAsync } from '../features/validationAsync/getPerformValidationAsync';
-import type { BaseInputComponent, OnPersistAsync, OnValueChange, RepeatableSummary, UpdateComponent, ValidationAsyncState } from '../types';
+import type { BaseInputComponent, OnComponentUpdate, OnPersistAsync, OnValueChange, RepeatableSummary, ValidationAsyncState } from '../types';
 export type IntegerInputComponent = BaseInputComponent<number | null> & {
     type: 'integer';
     kind: 'input';
@@ -17,4 +17,4 @@ export declare const createIntegerInputComponent: (integerInputProps: Pick<Integ
     onValueChange: OnValueChange;
     onPersistAsync: OnPersistAsync | undefined;
     summariser: (value: number | null) => RepeatableSummary;
-}, updateComponent: UpdateComponent) => IntegerInputComponent;
+}, onComponentUpdate: OnComponentUpdate) => IntegerInputComponent;

package/build/types/domain/components/ModalComponent.d.ts

@@ -1,4 +1,4 @@
-import type { BaseComponent, DomainComponent, UpdateComponent } from '../types';
+import type { BaseComponent, DomainComponent, OnComponentUpdate } from '../types';
 export type ModalComponent = BaseComponent & {
     type: 'modal';
     kind: 'layout';
@@ -9,4 +9,4 @@ export type ModalComponent = BaseComponent & {
     getChildren: () => DomainComponent[];
     close: () => void;
 };
-export declare const createModalContentComponent: (modalProps: Pick<ModalComponent, "uid" | "analyticsId" | "components" | "tags" | "title">, updateComponent: UpdateComponent) => ModalComponent;
+export declare const createModalContentComponent: (modalProps: Pick<ModalComponent, "uid" | "analyticsId" | "components" | "tags" | "title">, onComponentUpdate: OnComponentUpdate) => ModalComponent;

package/build/types/domain/components/MoneyInputComponent.d.ts

@@ -1,6 +1,6 @@
 import { JsonObject } from '@wise/dynamic-flow-types/spec';
 import { IsInvalidCheck } from '../features/validation/value-checks';
-import { BaseInputComponent, LocalValue, LocalValueObject, RepeatableSummary, UpdateComponent } from '../types';
+import { BaseInputComponent, LocalValue, LocalValueObject, OnComponentUpdate, RepeatableSummary } from '../types';
 import { SelectInputComponent } from './SelectInputComponent';
 import { TextInputComponent } from './TextInputComponent';
 export type MoneyInputComponent = BaseInputComponent<LocalValueObject> & {
@@ -19,4 +19,4 @@ export declare const createMoneyInputComponent: (moneyInputProps: Pick<MoneyInpu
     extraValues: JsonObject;
     checks: IsInvalidCheck<string | null>[];
     summariser: (value: LocalValue | null) => RepeatableSummary;
-}, updateComponent: UpdateComponent) => MoneyInputComponent;
+}, onComponentUpdate: OnComponentUpdate) => MoneyInputComponent;

package/build/types/domain/components/MultiSelectInputComponent.d.ts

@@ -1,7 +1,7 @@
 import type { SchemaOnChange } from '../features/schema-on-change/getSchemaOnChange';
 import type { IsInvalidCheck } from '../features/validation/value-checks';
 import type { PerformValidationAsync } from '../features/validationAsync/getPerformValidationAsync';
-import type { BaseInputComponent, LocalValue, LocalValueArray, OnValueChange, SchemaComponent, UpdateComponent, ValidationAsyncState } from '../types';
+import type { BaseInputComponent, LocalValue, LocalValueArray, OnValueChange, SchemaComponent, OnComponentUpdate, ValidationAsyncState } from '../types';
 import type { SelectInputOption } from './SelectInputComponent';
 export type MultiSelectComponent = BaseInputComponent<LocalValueArray | null> & {
     type: 'multi-select';
@@ -25,4 +25,4 @@ export declare const createMultiSelectComponent: (multiSelectProps: Pick<MultiSe
     performValidationAsync: PerformValidationAsync | undefined;
     schemaOnChange: SchemaOnChange | undefined;
     onValueChange: OnValueChange;
-}, updateComponent: UpdateComponent) => MultiSelectComponent;
+}, onComponentUpdate: OnComponentUpdate) => MultiSelectComponent;

package/build/types/domain/components/MultiUploadInputComponent.d.ts

@@ -1,7 +1,7 @@
 import { JsonElement } from '@wise/dynamic-flow-types/spec';
 import type { PerformPersistAsync } from '../features/persistAsync/getPerformPersistAsync';
 import type { IsInvalidCheck } from '../features/validation/value-checks';
-import type { BaseInputComponent, OnValueChange, PersistedState, RepeatableSummary, UpdateComponent, UploadSource } from '../types';
+import type { BaseInputComponent, OnComponentUpdate, OnValueChange, PersistedState, RepeatableSummary, UploadSource } from '../types';
 export type MultiUploadInputComponent = BaseInputComponent<File[]> & {
     type: 'multi-upload';
     kind: 'input';
@@ -30,4 +30,4 @@ export declare const createMultiUploadInputComponent: (uploadInputProps: Pick<Mu
     performPersistAsync: PerformPersistAsync | undefined;
     onValueChange: OnValueChange;
     summariser: (value: string[]) => RepeatableSummary;
-}, updateComponent: UpdateComponent) => MultiUploadInputComponent;
+}, onComponentUpdate: OnComponentUpdate) => MultiUploadInputComponent;

package/build/types/domain/components/NumberInputComponent.d.ts

@@ -1,7 +1,7 @@
 import type { SchemaOnChange } from '../features/schema-on-change/getSchemaOnChange';
 import type { IsInvalidCheck } from '../features/validation/value-checks';
 import type { PerformValidationAsync } from '../features/validationAsync/getPerformValidationAsync';
-import type { BaseInputComponent, OnPersistAsync, OnValueChange, RepeatableSummary, UpdateComponent, ValidationAsyncState } from '../types';
+import type { BaseInputComponent, OnComponentUpdate, OnPersistAsync, OnValueChange, RepeatableSummary, ValidationAsyncState } from '../types';
 export type NumberInputComponent = BaseInputComponent<number | null> & {
     type: 'number';
     kind: 'input';
@@ -17,4 +17,4 @@ export declare const createNumberInputComponent: (numberInputProps: Pick<NumberI
     onValueChange: OnValueChange;
     onPersistAsync: OnPersistAsync | undefined;
     summariser: (value: number | null) => RepeatableSummary;
-}, updateComponent: UpdateComponent) => NumberInputComponent;
+}, onComponentUpdate: OnComponentUpdate) => NumberInputComponent;

package/build/types/domain/components/PersistAsyncComponent.d.ts

@@ -1,7 +1,7 @@
 import { JsonElement } from '@wise/dynamic-flow-types/spec';
 import { PerformPersistAsync } from '../features/persistAsync/getPerformPersistAsync';
 import { SchemaOnChange } from '../features/schema-on-change/getSchemaOnChange';
-import type { BaseSchemaComponent, LocalValue, SchemaComponent, UpdateComponent } from '../types';
+import type { BaseSchemaComponent, LocalValue, OnComponentUpdate, SchemaComponent } from '../types';
 export type PersistAsyncComponent = BaseSchemaComponent<LocalValue> & {
     type: 'persist-async';
     kind: 'input';
@@ -16,4 +16,4 @@ export type PersistAsyncComponent = BaseSchemaComponent<LocalValue> & {
 export declare const createPersistAsyncComponent: (props: Pick<PersistAsyncComponent, "uid" | "analyticsId" | "schemaId" | "component" | "hidden" | "tags"> & {
     model?: JsonElement | null;
     localValue?: LocalValue | null;
-}, performPersistAsync: PerformPersistAsync, schemaOnChange: SchemaOnChange | undefined, updateComponent: UpdateComponent) => PersistAsyncComponent;
+}, performPersistAsync: PerformPersistAsync, schemaOnChange: SchemaOnChange | undefined, onComponentUpdate: OnComponentUpdate) => PersistAsyncComponent;

package/build/types/domain/components/RepeatableComponent.d.ts

@@ -1,5 +1,5 @@
 import type { IsInvalidCheck } from '../features/validation/value-checks';
-import type { BaseSchemaComponent, InlineAlert, LocalValue, LocalValueArray, Media, OnValueChange, RepeatableSummary, SchemaComponent, UpdateComponent } from '../types';
+import type { BaseSchemaComponent, InlineAlert, LocalValue, LocalValueArray, Media, OnComponentUpdate, OnValueChange, RepeatableSummary, SchemaComponent } from '../types';
 export type RepeatableComponent = BaseSchemaComponent<LocalValueArray> & {
     type: 'repeatable';
     kind: 'input';
@@ -34,5 +34,5 @@ export declare const createRepeatableComponent: (repeatableProps: Pick<Repeatabl
     summariser: (value: LocalValueArray | null) => RepeatableSummary;
     onValueChange: OnValueChange;
     createEditableComponent: (value: LocalValue) => SchemaComponent;
-}, updateComponent: UpdateComponent) => RepeatableComponent;
+}, onComponentUpdate: OnComponentUpdate) => RepeatableComponent;
 export {};

package/build/types/domain/components/RootDomainComponent.d.ts

@@ -1,17 +1,22 @@
 import { Model } from '@wise/dynamic-flow-types/spec';
 import { AnalyticsEventDispatcher } from '../features/events';
-import { BaseComponent, DomainComponent, LoadingState, LocalValue, SchemaComponent, ScrollToTop, UpdateComponent } from '../types';
+import { BaseComponent, DomainComponent, LoadingState, LocalValue, SchemaComponent, ScrollToTop, OnComponentUpdate } from '../types';
 import { ModalComponent } from './ModalComponent';
 import { StepDomainComponent } from './step/StepDomainComponent';
+import { SubflowDomainComponent } from './SubflowDomainComponent';
+import { RequestCache } from '../prefetching/request-cache';
+export type BackConfig = {
+    isNativeBackEnabled: boolean;
+    isFlowCancellable: boolean;
+};
 export type RootDomainComponent = BaseComponent & {
     type: 'root';
     kind: 'step';
     stepComponent: StepDomainComponent | null;
     stepStack: StepDomainComponent[];
-    backConfig: {
-        isNativeBackEnabled: boolean;
-        isFlowCancellable: boolean;
-    };
+    subflow: SubflowDomainComponent | null;
+    backConfig: BackConfig;
+    requestCache: RequestCache;
     canPerformBack: () => boolean;
     dismissAllModals: () => void;
     dismissModal: () => void;
@@ -35,8 +40,7 @@ export type RootDomainComponent = BaseComponent & {
     clearStack: () => void;
     navigateBack: () => void;
     getRefreshUrl: () => string | null;
+    addSubflow: (subflow: SubflowDomainComponent) => void;
+    closeSubflow: () => void;
 };
-export declare const createRootDomainComponent: (updateComponent: UpdateComponent, scrollToTop: ScrollToTop, backConfig: {
-    isNativeBackEnabled: boolean;
-    isFlowCancellable: boolean;
-}) => RootDomainComponent;
+export declare const createRootDomainComponent: (onComponentUpdate: OnComponentUpdate, scrollToTop: ScrollToTop, backConfig: BackConfig, requestCache: RequestCache) => RootDomainComponent;

package/build/types/domain/components/SelectInputComponent.d.ts

@@ -1,9 +1,8 @@
 import type { Model } from '@wise/dynamic-flow-types/spec';
 import type { AnalyticsEventDispatcher } from '../features/events';
 import type { SchemaOnChange } from '../features/schema-on-change/getSchemaOnChange';
-import type { InlineAlert, SupportingValues } from '../types';
 import type { IsInvalidCheck } from '../features/validation/value-checks';
-import type { BaseInputComponent, LocalValue, Media, OnValueChange, RepeatableSummary, SchemaComponent, UpdateComponent } from '../types';
+import type { BaseInputComponent, InlineAlert, LocalValue, Media, OnComponentUpdate, OnValueChange, RepeatableSummary, SchemaComponent, SupportingValues } from '../types';
 export type SelectInputComponent = BaseInputComponent<LocalValue | null> & {
     type: 'select';
     kind: 'input';
@@ -37,4 +36,4 @@ export declare const createSelectInputComponent: (selectProps: Pick<SelectInputC
     summariser: (value: LocalValue | null) => RepeatableSummary;
     onValueChange: OnValueChange;
     trackEvent: AnalyticsEventDispatcher;
-}, updateComponent: UpdateComponent) => SelectInputComponent;
+}, onComponentUpdate: OnComponentUpdate) => SelectInputComponent;

package/build/types/domain/components/SubflowDomainComponent.d.ts

@@ -0,0 +1,16 @@
+import { JsonElement, Request } from '@wise/dynamic-flow-types/spec';
+import { AnalyticsEventDispatcher } from '../features/events';
+import { RequestCache } from '../prefetching/request-cache';
+import { BaseComponent, OnComponentUpdate, Presentation } from '../types';
+export type SubflowDomainComponent = BaseComponent & {
+    kind: 'layout';
+    type: 'subflow';
+    presentation: Presentation;
+    initialRequest: Request;
+    requestCache: RequestCache;
+    onCancellation: () => void;
+    onCompletion: (result: JsonElement) => void;
+    onEvent: AnalyticsEventDispatcher<string>;
+    onError: (error: unknown, status?: number) => void;
+};
+export declare const createSubflowDomainComponent: (subflowProps: Pick<SubflowDomainComponent, "initialRequest" | "presentation" | "requestCache" | "onCompletion" | "onCancellation" | "onError" | "onEvent">, onComponentUpdate: OnComponentUpdate) => SubflowDomainComponent;

package/build/types/domain/components/TextInputComponent.d.ts

@@ -1,7 +1,7 @@
 import type { SchemaOnChange } from '../features/schema-on-change/getSchemaOnChange';
 import type { IsInvalidCheck } from '../features/validation/value-checks';
 import type { PerformValidationAsync } from '../features/validationAsync/getPerformValidationAsync';
-import type { Autocapitalization, BaseInputComponent, OnPersistAsync, OnValueChange, RepeatableSummary, Suggestions, UpdateComponent, ValidationAsyncState } from '../types';
+import type { Autocapitalization, BaseInputComponent, OnComponentUpdate, OnPersistAsync, OnValueChange, RepeatableSummary, Suggestions, ValidationAsyncState } from '../types';
 export type TextInputComponent = BaseInputComponent<string | null> & {
     type: 'text';
     kind: 'input';
@@ -20,4 +20,4 @@ export declare const createTextInputComponent: (textInputProps: Pick<TextInputCo
     onValueChange: OnValueChange;
     onPersistAsync: OnPersistAsync | undefined;
     summariser: (value: string | null) => RepeatableSummary;
-}, updateComponent: UpdateComponent) => TextInputComponent;
+}, onComponentUpdate: OnComponentUpdate) => TextInputComponent;

package/build/types/domain/components/UploadInputComponent.d.ts

@@ -1,7 +1,7 @@
 import type { JsonElement } from '@wise/dynamic-flow-types/spec';
 import type { SchemaOnChange } from '../features/schema-on-change/getSchemaOnChange';
 import type { IsInvalidCheck } from '../features/validation/value-checks';
-import type { BaseInputComponent, OnPersistAsync, OnValueChange, RepeatableSummary, UpdateComponent, UploadSource } from '../types';
+import type { BaseInputComponent, OnComponentUpdate, OnPersistAsync, OnValueChange, RepeatableSummary, UploadSource } from '../types';
 export type UploadInputComponent = BaseInputComponent<File | null> & {
     type: 'upload';
     kind: 'input';
@@ -20,4 +20,4 @@ export declare const createUploadInputComponent: (uploadInputProps: Pick<UploadI
     onValueChange: OnValueChange;
     onPersistAsync: OnPersistAsync | undefined;
     summariser: (value: string | null) => RepeatableSummary;
-}, updateComponent: UpdateComponent) => UploadInputComponent;
+}, onComponentUpdate: OnComponentUpdate) => UploadInputComponent;

package/build/types/domain/components/searchComponent/SearchComponent.d.ts

@@ -1,5 +1,5 @@
 import type { SearchResult } from '@wise/dynamic-flow-types/spec';
-import type { BaseLayoutComponent, OnBehavior, UpdateComponent } from '../../types';
+import type { BaseLayoutComponent, OnBehavior, OnComponentUpdate } from '../../types';
 export type SearchConfig = {
     method: string;
     param: string;
@@ -23,4 +23,4 @@ export type SearchComponent = BaseLayoutComponent & {
     onChange: (query: string) => void;
     onSelect: (result: SearchResult) => void;
 };
-export declare const createSearchComponent: (searchProps: Pick<SearchComponent, "uid" | "analyticsId" | "control" | "emptyMessage" | "margin" | "tags" | "title">, performSearch: PerformSearch, onBehavior: OnBehavior, updateComponent: UpdateComponent) => SearchComponent;
+export declare const createSearchComponent: (searchProps: Pick<SearchComponent, "uid" | "analyticsId" | "control" | "emptyMessage" | "margin" | "tags" | "title">, performSearch: PerformSearch, onBehavior: OnBehavior, onComponentUpdate: OnComponentUpdate) => SearchComponent;

package/build/types/domain/components/step/ExternalConfirmationComponent.d.ts

@@ -1,4 +1,4 @@
-import { BaseComponent, UpdateComponent } from '../../types';
+import { BaseComponent, OnComponentUpdate } from '../../types';
 export type ExternalConfirmationComponent = BaseComponent & {
     type: 'external-confirmation';
     kind: 'layout';
@@ -9,4 +9,4 @@ export type ExternalConfirmationComponent = BaseComponent & {
     onFailure: () => void;
     onCancel: () => void;
 };
-export declare const createExternalConfirmation: (uid: string, url: string, updateComponent: UpdateComponent) => ExternalConfirmationComponent;
+export declare const createExternalConfirmation: (uid: string, url: string, onComponentUpdate: OnComponentUpdate) => ExternalConfirmationComponent;

package/build/types/domain/components/step/StepDomainComponent.d.ts

@@ -1,7 +1,7 @@
-import type { BaseComponent, DomainComponent, LayoutComponent, LoadingState, LocalValue, OnBehavior, SchemaComponent, UpdateComponent } from '../../types';
+import type { BaseComponent, DomainComponent, LayoutComponent, LoadingState, LocalValue, OnBehavior, SchemaComponent, OnComponentUpdate } from '../../types';
 import type { NavigationStackBehavior, Step } from '@wise/dynamic-flow-types/spec';
 import { Model } from '@wise/dynamic-flow-types/spec';
-import { SubmissionRequestCache } from '../../prefetching/request-cache';
+import { RequestCache } from '../../prefetching/request-cache';
 import type { AnalyticsEventDispatcher } from '../../features/events';
 import type { StepPolling } from '../../features/polling/getStepPolling';
 import { StepRefreshAfter } from '../../features/refreshAfter/getStepRefreshAfter';
@@ -27,7 +27,7 @@ export type StepDomainComponent = BaseComponent & {
     title?: string;
     modals: ModalComponent[];
     tags?: string[];
-    submissionRequestsCache: SubmissionRequestCache;
+    requestCache: RequestCache;
     dismissModal: () => void;
     dismissAllModals: () => void;
     showModal: (modal: ModalComponent) => void;
@@ -47,8 +47,8 @@ export type BackNavigation = {
     title?: string;
     onClick: () => void;
 };
-export declare const createStepComponent: (stepProps: Pick<StepDomainComponent, "uid" | "back" | "toolbar" | "layoutComponents" | "schemaComponents" | "footerComponents" | "control" | "description" | "error" | "externalConfirmation" | "loadingState" | "stackBehavior" | "etag" | "step" | "title" | "tags" | "submissionRequestsCache" | "trackEvent" | "onBehavior"> & {
+export declare const createStepComponent: (stepProps: Pick<StepDomainComponent, "uid" | "back" | "toolbar" | "layoutComponents" | "schemaComponents" | "footerComponents" | "control" | "description" | "error" | "externalConfirmation" | "loadingState" | "stackBehavior" | "etag" | "step" | "title" | "tags" | "requestCache" | "trackEvent" | "onBehavior"> & {
     stepPolling?: StepPolling;
     stepRefreshAfter?: StepRefreshAfter;
-    updateComponent: UpdateComponent;
+    onComponentUpdate: OnComponentUpdate;
 }) => StepDomainComponent;

package/build/types/domain/components/utils/component-utils.d.ts

@@ -1,8 +1,8 @@
-import type { DomainComponent, UpdateComponent } from '../../types';
+import type { DomainComponent, OnComponentUpdate } from '../../types';
 /**
  * Helper function to update a component.
  *
- * @param updateComponent the updateComponent function that will update the component with the given uid
- * @returns a function that accepts a component and returns a function that takes a function that will update the component and call `updateComponent` to notify that there has been a change.
+ * @param onComponentUpdate the function that will notify the view layer that something has changed in the domain layer
+ * @returns a function that can be used to update components without the linter shouting at us.
  */
-export declare const getInputUpdateFunction: <C extends DomainComponent>(updateComponent: UpdateComponent) => (component: C, updateFn: (component: C) => void) => void;
+export declare const getInputUpdateFunction: <C extends DomainComponent>(onComponentUpdate: OnComponentUpdate) => (component: C, updateFn: (component: C) => void) => void;

package/build/types/domain/features/eventNames.d.ts

@@ -0,0 +1 @@
+export declare const eventNames: readonly ["Initiated", "Succeeded", "Failed", "Cancelled", "Step Shown", "Action Triggered", "Action Succeeded", "Action Aborted", "Action Failed", "Refresh Triggered", "Refresh Succeeded", "Refresh Aborted", "Refresh Failed", "OneOf Selected", "OneOf Option Selected", "PersistAsync Triggered", "PersistAsync Succeeded", "PersistAsync Failed", "Polling Failed", "ValidationAsync Triggered", "ValidationAsync Succeeded", "ValidationAsync Failed"];

package/build/types/domain/features/events.d.ts

@@ -1,6 +1,7 @@
+import { eventNames } from './eventNames';
 export type AnalyticsEventHandler = (eventName: string, properties?: Record<string, unknown>) => void;
 export type AnalyticsEventDispatcher<E extends string = EventName> = (eventName: E, properties?: Record<string, unknown>) => void;
-export type EventName = 'Initiated' | 'Succeeded' | 'Failed' | 'Cancelled' | 'Step Shown' | 'Action Triggered' | 'Action Succeeded' | 'Action Aborted' | 'Action Failed' | 'Refresh Triggered' | 'Refresh Succeeded' | 'Refresh Aborted' | 'Refresh Failed' | 'OneOf Selected' | 'PersistAsync Triggered' | 'PersistAsync Succeeded' | 'PersistAsync Failed' | 'Polling Failed' | 'ValidationAsync Triggered' | 'ValidationAsync Succeeded' | 'ValidationAsync Failed' | 'Value Changed';
+export type EventName = (typeof eventNames)[number];
 export type LogLevel = 'info' | 'warning' | 'error';
 export type LoggingEventHandler = (level: LogLevel, message: string, extra: Record<string, unknown>) => void;
 export type LoggingEventDispatcher = (level: LogLevel, message: string, extra?: Record<string, unknown>) => void;

package/build/types/domain/mappers/mapStepToComponent.d.ts

@@ -1,4 +1,5 @@
 import type { AnalyticsEventDispatcher } from '../features/events';
+import { RequestCache } from '../prefetching/request-cache';
 import type { LoadingState, OnPoll } from '../types';
 import type { MapperProps } from './schema/types';
 import { FeatureFlags } from './utils/FeatureFlags';
@@ -8,6 +9,7 @@ export type StepMapperProps = Omit<MapperProps, 'trackEvent' | 'registerSubmissi
     loadingState: LoadingState;
     trackEvent: AnalyticsEventDispatcher<string>;
     features: FeatureFlags;
+    flowRequestCache: RequestCache;
     onPoll: OnPoll;
 };
 export declare const mapStepToComponent: ({ uid: rootUid, loadingState, features, trackEvent, onPoll, onBehavior, ...restProps }: StepMapperProps) => import("../components/step/StepDomainComponent").StepDomainComponent;

package/build/types/domain/mappers/schema/types.d.ts

@@ -1,7 +1,7 @@
 import type { Step as DFStep, Model, Schema, ValidationError } from '@wise/dynamic-flow-types/spec';
 import type { HttpClient } from '../../../types';
 import type { AnalyticsEventDispatcher, LoggingEventDispatcher } from '../../features/events';
-import type { Behavior, LocalValue, OnBehavior, OnPersistAsync, OnValueChange, UpdateComponent } from '../../types';
+import type { Behavior, LocalValue, OnBehavior, OnPersistAsync, OnValueChange, OnComponentUpdate } from '../../types';
 import type { GetErrorMessageFunctions, PersistAsyncConfig } from '../types';
 export type MapperProps = {
     stepLocalValue: LocalValue;
@@ -10,7 +10,7 @@ export type MapperProps = {
     httpClient: HttpClient;
     onBehavior: OnBehavior;
     onValueChange: OnValueChange;
-    updateComponent: UpdateComponent;
+    onComponentUpdate: OnComponentUpdate;
     trackEvent: AnalyticsEventDispatcher;
     logEvent: LoggingEventDispatcher;
     registerSubmissionBehavior: (behavior: Behavior) => void;

package/build/types/domain/prefetching/request-cache.d.ts

@@ -1,9 +1,9 @@
 import { HttpClient } from '../../types';
-export type SubmissionRequestCache = {
-    has: (...requestParams: Parameters<HttpClient>) => boolean;
-    get: (...requestParams: Parameters<HttpClient>) => Promise<Response | null> | undefined;
-    delete: (...requestParams: Parameters<HttpClient>) => boolean;
-    set: (...[input, init, response]: [...Parameters<HttpClient>, Promise<Response | null>]) => void;
-    clear: () => void;
+export type RequestCache = {
+    get: (requestParams: Parameters<HttpClient>) => Promise<Response | null> | undefined;
+    set: (requestParams: Parameters<HttpClient>, responsePromise: Promise<Response | null>) => void;
 };
-export declare const makeRequestCache: () => SubmissionRequestCache;
+export type RequestCacheEntries = readonly [Parameters<HttpClient>, Promise<Response | null>][];
+export declare const makeRequestCacheWithParent: (parent: RequestCache | undefined) => RequestCache;
+export declare const makeRequestCache: (initialValues?: RequestCacheEntries) => RequestCache;
+export declare const normaliseRequestCache: (cache: RequestCache | RequestCacheEntries | undefined) => RequestCache;

package/build/types/domain/types.d.ts

@@ -1,4 +1,4 @@
-import type { Action, ActionBehavior, CopyBehavior, DismissBehavior, Icon, JsonElement, LinkBehavior, Margin, ModalBehavior, Model } from '@wise/dynamic-flow-types/spec';
+import type { Action, ActionBehavior, CopyBehavior, DismissBehavior, Icon, JsonElement, LaunchConfig, LinkBehavior, Margin, ModalBehavior, Model } from '@wise/dynamic-flow-types/spec';
 import type { AlertComponent } from './components/AlertComponent';
 import type { AllOfComponent } from './components/AllOfComponent';
 import type { BooleanInputComponent } from './components/BooleanInputComponent';
@@ -42,7 +42,8 @@ import type { TabsComponent } from './components/TabsComponent';
 import type { TextInputComponent } from './components/TextInputComponent';
 import type { TupleComponent } from './components/TupleComponent';
 import type { UploadInputComponent } from './components/UploadInputComponent';
-export type DomainComponent = RootDomainComponent | StepDomainComponent | PersistAsyncComponent | AllOfComponent | BooleanInputComponent | ConstComponent | DateInputComponent | IntegerInputComponent | MultiSelectComponent | MultiUploadInputComponent | NumberInputComponent | ObjectComponent | RepeatableComponent | SelectInputComponent | TextInputComponent | TupleComponent | UploadInputComponent | AlertComponent | BoxComponent | ButtonComponent | ColumnsComponent | ContainerComponent | DecisionComponent | DividerComponent | ExternalConfirmationComponent | FormattedValueComponent | FormComponent | HeadingComponent | ImageComponent | InstructionsComponent | ListComponent | LoadingIndicatorComponent | MarkdownComponent | ModalLayoutComponent | ModalComponent | MoneyInputComponent | ParagraphComponent | ProgressComponent | ReviewComponent | SearchComponent | SectionComponent | StatusListComponent | TabsComponent;
+import type { SubflowDomainComponent } from './components/SubflowDomainComponent';
+export type DomainComponent = RootDomainComponent | StepDomainComponent | PersistAsyncComponent | AllOfComponent | BooleanInputComponent | ConstComponent | DateInputComponent | IntegerInputComponent | MultiSelectComponent | MultiUploadInputComponent | NumberInputComponent | ObjectComponent | RepeatableComponent | SelectInputComponent | TextInputComponent | TupleComponent | UploadInputComponent | AlertComponent | BoxComponent | ButtonComponent | ColumnsComponent | ContainerComponent | DecisionComponent | DividerComponent | ExternalConfirmationComponent | FormattedValueComponent | FormComponent | HeadingComponent | ImageComponent | InstructionsComponent | ListComponent | LoadingIndicatorComponent | MarkdownComponent | ModalLayoutComponent | ModalComponent | MoneyInputComponent | ParagraphComponent | ProgressComponent | ReviewComponent | SearchComponent | SectionComponent | StatusListComponent | SubflowDomainComponent | TabsComponent;
 export type SchemaComponent = DomainComponent & {
     kind: 'input';
 };
@@ -67,9 +68,14 @@ export type CallToAction = {
     href: string;
     onClick: () => void;
 };
-export type Behavior = (ActionBehavior | CopyBehavior | DismissBehavior | LinkBehavior | ModalBehavior | NonMergingActionBehaviour | NullBehavior | RefreshBehavior | BackBehaviour) & {
+export type Behavior = (ActionBehavior | CopyBehavior | DismissBehavior | LinkBehavior | ModalBehavior | NonMergingActionBehaviour | NullBehavior | RefreshBehavior | BackBehaviour | SubflowBehavior) & {
     analytics?: Record<string, unknown>;
 };
+export type Presentation = {
+    type: 'modal';
+} | {
+    type: 'push';
+};
 type NonMergingActionBehaviour = Omit<ActionBehavior, 'type'> & {
     type: 'non-merging-action';
 };
@@ -84,6 +90,14 @@ type RefreshBehavior = {
     type: 'refresh';
     url?: string;
 };
+export type SubflowBehavior = {
+    type: 'subflow';
+    referrerId: string;
+    launchConfig: LaunchConfig;
+    resultKey?: string;
+    onCompletion?: Behavior;
+    onError?: Behavior;
+};
 export type BaseComponent = {
     kind: 'step' | 'input' | 'layout';
     type: string;
@@ -160,7 +174,7 @@ export type BaseInputComponent<LV extends LocalValue> = BaseSchemaComponent<LV>
     onBlur: () => void;
     onFocus: () => void;
 };
-export type UpdateComponent = () => void;
+export type OnComponentUpdate = () => void;
 export type ScrollToTop = (behavior: ScrollBehavior) => void;
 export type OnBehavior = (behavior: Behavior) => Promise<BehaviorController>;
 export type BehaviorController = {