@owlmeans/client-flow 0.1.0

package/build/client.d.ts

@@ -0,0 +1,5 @@
+import type { ClientContext, Navigator } from '@owlmeans/client';
+import type { ClientConfig } from '@owlmeans/client-context';
+import type { FlowClient } from './types.js';
+export declare const createFlowClient: <C extends ClientConfig, T extends ClientContext<C>>(context: T, nav: Navigator) => FlowClient;
+//# sourceMappingURL=client.d.ts.map

package/build/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAQ5D,OAAO,KAAK,EAAE,UAAU,EAA8B,MAAM,YAAY,CAAA;AAIxE,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,SAAS,KAAG,UA+GjH,CAAA"}

package/build/client.js

@@ -0,0 +1,97 @@
+import { module, stab } from '@owlmeans/client-module';
+import { route, frontend } from '@owlmeans/route';
+import { FlowStepMissconfigured, FlowTargetError, TARGET_SERVICE } from '@owlmeans/flow';
+import { ResilientError } from '@owlmeans/error';
+import { DEFAULT_ALIAS, FLOW_STATE, REHACK_MOD } from './consts.js';
+import { DISPATCHER_PATH } from '@owlmeans/auth-common';
+export const createFlowClient = (context, nav) => {
+    const service = context.service(DEFAULT_ALIAS);
+    let model;
+    const _client = {
+        boot: async (targetAlias, from) => {
+            await service.ready();
+            let _model = await service.state();
+            if (_model == null) {
+                if (context.hasResource(FLOW_STATE)) {
+                    const resource = context.resource(FLOW_STATE);
+                    const record = await resource.load(FLOW_STATE);
+                    if (record != null) {
+                        _model = await service.begin(record.flow);
+                        _model.setState(record);
+                        if (targetAlias == null) {
+                            targetAlias = record.service;
+                        }
+                    }
+                }
+                if (_model == null) {
+                    _model = await service.begin(undefined, from);
+                }
+                if (targetAlias != null) {
+                    let target;
+                    try {
+                        target = context.serviceRoute(targetAlias);
+                    }
+                    catch (e) {
+                        const err = ResilientError.ensure(e);
+                        const error = new FlowTargetError(targetAlias);
+                        error.oiriginalStack = err.stack;
+                        throw error;
+                    }
+                    _model.target(target.service);
+                }
+            }
+            model = _model;
+            return _client;
+        },
+        setup: flow => {
+            model = flow;
+            return _client;
+        },
+        flow: () => model,
+        service: () => context.serviceRoute(model.state().service),
+        // @TODO Reuse service's proceed method to avoid code ambiguity and duplication
+        proceed: async (transition, req) => {
+            const step = model.step(transition.step);
+            if (step.module == null) {
+                throw new FlowStepMissconfigured(step.step);
+            }
+            // @TODO I'm not sure it's always ok to pass previous payload.
+            // It should be configurable some way.
+            const previous = model.payload();
+            // @TODO Such payload pass may duplicate some query paramters in some 
+            // case. But in general payloadMaping should protect from most of issues.
+            // In general we may stop to pass any params outside the flow state.
+            // !!! Probably we can configure what goes there by the flow config.
+            model.transit(transition.transition, true, { ...previous, ...req?.params, ...req?.query });
+            let redirectTo;
+            // @TODO Properly use target service - as a way to build the redirect URL
+            if (step.service === TARGET_SERVICE) {
+                context.registerModule(module(route(REHACK_MOD, DISPATCHER_PATH, frontend({ service: model.state().service })), stab));
+                redirectTo = context.module(REHACK_MOD);
+                await redirectTo.resolve();
+                step.module = REHACK_MOD;
+            }
+            else {
+                redirectTo = context.module(step.module);
+            }
+            const [url] = await redirectTo.call(req);
+            if (url.startsWith('http')) {
+                await service.proceed(req);
+            }
+            else {
+                await nav.navigate(redirectTo, req);
+            }
+        },
+        persist: async () => {
+            if (context.hasResource(FLOW_STATE)) {
+                const resource = context.resource(FLOW_STATE);
+                const _state = model.state();
+                await resource.save({ ..._state, id: FLOW_STATE });
+                return true;
+            }
+            return false;
+        }
+    };
+    return _client;
+};
+//# sourceMappingURL=client.js.map

package/build/client.js.map

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

package/build/consts.d.ts

@@ -0,0 +1,4 @@
+export declare const DEFAULT_ALIAS = "flow";
+export declare const FLOW_STATE = "state:flow";
+export declare const REHACK_MOD = "__redirect";
+//# sourceMappingURL=consts.d.ts.map

package/build/consts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,aAAa,SAAS,CAAA;AAEnC,eAAO,MAAM,UAAU,eAAe,CAAA;AAEtC,eAAO,MAAM,UAAU,eAAe,CAAA"}

package/build/consts.js

@@ -0,0 +1,4 @@
+export const DEFAULT_ALIAS = 'flow';
+export const FLOW_STATE = 'state:flow';
+export const REHACK_MOD = '__redirect';
+//# sourceMappingURL=consts.js.map

package/build/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAA;AAEnC,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAA;AAEtC,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAA"}

package/build/index.d.ts

@@ -0,0 +1,5 @@
+export type * from './types.js';
+export * from './consts.js';
+export * from './client.js';
+export * from './service.js';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,YAAY,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA"}

package/build/index.js

@@ -0,0 +1,4 @@
+export * from './consts.js';
+export * from './client.js';
+export * from './service.js';
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA"}

package/build/service.d.ts

@@ -0,0 +1,3 @@
+import type { FlowService } from './types.js';
+export declare const makeBasicFlowService: (alias?: string) => FlowService;
+//# sourceMappingURL=service.d.ts.map

package/build/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,YAAY,CAAA;AAI1D,eAAO,MAAM,oBAAoB,WAAW,MAAM,KAAmB,WAwGpE,CAAA"}

package/build/service.js

@@ -0,0 +1,86 @@
+import { assertContext, createLazyService } from '@owlmeans/context';
+import { DEFAULT_ALIAS } from './consts.js';
+import { DEFAULT_ALIAS as CONFIG_RESOURCE, fromConfigRecord } from '@owlmeans/config';
+import { FLOW_RECORD, FlowUnsupported, makeFlowModel, STD_AUTH_FLOW, UnknownFlow } from '@owlmeans/flow';
+export const makeBasicFlowService = (alias = DEFAULT_ALIAS) => {
+    const location = `flow-service:${alias}`;
+    const pair = {
+        resolve: () => { },
+        reject: () => { }
+    };
+    const flows = {};
+    const service = createLazyService(alias, {
+        flow: null,
+        supplied: new Promise((resolve, reject) => {
+            pair.resolve = resolve;
+            pair.reject = reject;
+        }),
+        state: async () => {
+            await service.supplied;
+            return service.flow;
+        },
+        resolvePair: () => pair,
+        config: () => {
+            const ctx = assertContext(service.ctx, location);
+            return ctx.cfg.flowConfig ?? {};
+        },
+        begin: async (slug, from) => {
+            slug = slug ?? service.config().defaultFlow ?? STD_AUTH_FLOW;
+            service.flow = await makeFlowModel(slug, service.provideFlow);
+            service.supplied = Promise.resolve(true);
+            return service.flow.enter(from);
+        },
+        load: async (state) => {
+            service.flow = await makeFlowModel(state, service.provideFlow);
+            service.supplied = Promise.resolve(true);
+            return service.flow;
+        },
+        provideFlow: async (slug) => {
+            if (flows[slug] == null) {
+                throw new UnknownFlow(slug);
+            }
+            return flows[slug];
+        },
+        proceed: async () => {
+            throw new FlowUnsupported('service.proceed');
+        }
+    }, service => async () => {
+        const ctx = assertContext(service.ctx, location);
+        const flowCfg = service.config();
+        // @TODO Put it into some configuration and make it more flexible
+        const configRes = ctx.resource(CONFIG_RESOURCE);
+        const flowConfigs = await configRes.list({ recordType: FLOW_RECORD });
+        await Promise.all(flowConfigs.items.map(item => fromConfigRecord(item)).map(async (flow) => {
+            Object.values(flow.steps).forEach(step => {
+                if (step.service.startsWith('$')) {
+                    const service = flowCfg.services?.[step.service.substring(1)];
+                    if (service != null) {
+                        step.service = service;
+                    }
+                }
+                if (step.module != null && step.module.startsWith('$')) {
+                    const module = flowCfg.modules?.[step.module.substring(1)];
+                    if (module != null) {
+                        step.module = module;
+                    }
+                }
+                if (step.path != null && step.path.startsWith('$')) {
+                    const path = flowCfg.pathes?.[step.path.substring(1)];
+                    if (path != null) {
+                        step.path = path;
+                    }
+                }
+            });
+            flows[flow.flow] = {
+                ...flow, config: flowCfg, prefabs: Object.fromEntries(await Promise.all(Object.values(flow.steps).filter(step => step.initial === true)
+                    .map(async (step) => {
+                    const state = await makeFlowModel(flow);
+                    return [step.step, state.enter(step.step).serialize()];
+                })))
+            };
+        }));
+        service.initialized = true;
+    });
+    return service;
+};
+//# sourceMappingURL=service.js.map

package/build/service.js.map

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

package/build/types.d.ts

@@ -0,0 +1,34 @@
+import type { LazyService } from '@owlmeans/context';
+import type { FlowConfig, FlowModel, FlowProvider, FlowState, FlowTransition } from '@owlmeans/flow';
+import type { AbstractRequest } from '@owlmeans/module';
+import type { ResourceRecord } from '@owlmeans/resource';
+import type { ResolvedServiceRoute } from '@owlmeans/route';
+import type { ClientResource } from '@owlmeans/client-resource';
+export interface FlowService extends LazyService {
+    supplied: Promise<boolean>;
+    flow: FlowModel | null;
+    state: () => Promise<FlowModel | null>;
+    resolvePair: () => ResolvePair;
+    config: () => FlowConfig;
+    begin: (slug?: string, from?: string) => Promise<FlowModel>;
+    load: (flow: string) => Promise<FlowModel>;
+    provideFlow: FlowProvider;
+    proceed: (req?: Partial<AbstractRequest>, dryRun?: boolean) => Promise<string>;
+}
+export interface ResolvePair {
+    resolve: (val: boolean) => void;
+    reject: (err: Error) => void;
+}
+export interface FlowClient {
+    boot: (target: string | null, from?: string) => Promise<FlowClient>;
+    setup: (flow: FlowModel) => FlowClient;
+    flow: () => FlowModel;
+    service: () => ResolvedServiceRoute;
+    proceed: (transiation: FlowTransition, req?: Partial<AbstractRequest>) => Promise<void>;
+    persist: () => Promise<boolean>;
+}
+export interface StateRecord extends ResourceRecord, FlowState {
+}
+export interface StateResource extends ClientResource<StateRecord> {
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAE/D,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC9C,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;IAE1B,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;IAEtB,KAAK,EAAE,MAAM,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAA;IAEtC,WAAW,EAAE,MAAM,WAAW,CAAA;IAE9B,MAAM,EAAE,MAAM,UAAU,CAAA;IAExB,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAA;IAE3D,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAA;IAE1C,WAAW,EAAE,YAAY,CAAA;IAEzB,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAC/E;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IAChC,MAAM,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IACnE,KAAK,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,UAAU,CAAA;IACtC,IAAI,EAAE,MAAM,SAAS,CAAA;IACrB,OAAO,EAAE,MAAM,oBAAoB,CAAA;IACnC,OAAO,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACvF,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CAChC;AAED,MAAM,WAAW,WAAY,SAAQ,cAAc,EAAE,SAAS;CAAG;AAEjE,MAAM,WAAW,aAAc,SAAQ,cAAc,CAAC,WAAW,CAAC;CAAG"}

package/build/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@owlmeans/client-flow",
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "sleep 90 && nodemon -e ts,tsx,json --watch src --exec \"tsc -p ./tsconfig.json\"",
+    "watch": "tsc -b -w --preserveWatchOutput --pretty"
+  },
+  "main": "build/index.js",
+  "module": "build/index.js",
+  "types": "build/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./build/index.js",
+      "require": "./build/index.js",
+      "default": "./build/index.js",
+      "module": "./build/index.js",
+      "types": "./build/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@owlmeans/auth-common": "^0.1.0",
+    "@owlmeans/client": "^0.1.0",
+    "@owlmeans/client-context": "^0.1.0",
+    "@owlmeans/client-module": "^0.1.0",
+    "@owlmeans/client-resource": "^0.1.0",
+    "@owlmeans/config": "^0.1.0",
+    "@owlmeans/context": "^0.1.0",
+    "@owlmeans/error": "^0.1.0",
+    "@owlmeans/flow": "^0.1.0",
+    "@owlmeans/module": "^0.1.0",
+    "@owlmeans/resource": "^0.1.0",
+    "@owlmeans/route": "^0.1.0"
+  },
+  "peerDependencies": {
+    "react": "*"
+  },
+  "devDependencies": {
+    "nodemon": "^3.1.7",
+    "npm-check": "^6.0.1",
+    "typescript": "^5.6.3"
+  },
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/client.ts

@@ -0,0 +1,125 @@
+import type { ClientContext, Navigator } from '@owlmeans/client'
+import type { ClientConfig } from '@owlmeans/client-context'
+import type { ClientModule } from '@owlmeans/client-module'
+import { module, stab } from '@owlmeans/client-module'
+import type { ResolvedServiceRoute } from '@owlmeans/route'
+import { route, frontend } from '@owlmeans/route'
+import { FlowStepMissconfigured, FlowTargetError, TARGET_SERVICE } from '@owlmeans/flow'
+import type { FlowModel } from '@owlmeans/flow'
+import { ResilientError } from '@owlmeans/error'
+import type { FlowClient, FlowService, StateResource } from './types.js'
+import { DEFAULT_ALIAS, FLOW_STATE, REHACK_MOD } from './consts.js'
+import { DISPATCHER_PATH } from '@owlmeans/auth-common'
+
+export const createFlowClient = <C extends ClientConfig, T extends ClientContext<C>>(context: T, nav: Navigator): FlowClient => {
+  const service = context.service<FlowService>(DEFAULT_ALIAS)
+
+  let model: FlowModel
+
+  const _client: FlowClient = {
+    boot: async (targetAlias, from) => {
+      await service.ready()
+      let _model = await service.state()
+      if (_model == null) {
+        if (context.hasResource(FLOW_STATE)) {
+          const resource = context.resource<StateResource>(FLOW_STATE)
+          const record = await resource.load(FLOW_STATE)
+          if (record != null) {
+            _model = await service.begin(record.flow)
+            _model.setState(record)
+            if (targetAlias == null) {
+              targetAlias = record.service
+            }
+          }
+        }
+        if (_model == null) {
+          _model = await service.begin(undefined, from)
+        }
+
+        if (targetAlias != null) {
+          let target: ResolvedServiceRoute
+          try {
+            target = context.serviceRoute(targetAlias) as ResolvedServiceRoute
+          } catch (e) {
+            const err = ResilientError.ensure(e as Error)
+            const error = new FlowTargetError(targetAlias)
+            error.oiriginalStack = err.stack
+
+            throw error
+          }
+          _model.target(target.service)
+        }
+      }
+
+      model = _model
+
+      return _client
+    },
+
+    setup: flow => {
+      model = flow
+
+      return _client
+    },
+
+    flow: () => model,
+
+    service: () => context.serviceRoute(model.state().service) as ResolvedServiceRoute,
+
+    // @TODO Reuse service's proceed method to avoid code ambiguity and duplication
+    proceed: async (transition, req) => {
+      const step = model.step(transition.step)
+      if (step.module == null) {
+        throw new FlowStepMissconfigured(step.step)
+      }
+
+
+      // @TODO I'm not sure it's always ok to pass previous payload.
+      // It should be configurable some way.
+      const previous = model.payload()
+      // @TODO Such payload pass may duplicate some query paramters in some 
+      // case. But in general payloadMaping should protect from most of issues.
+      // In general we may stop to pass any params outside the flow state.
+      // !!! Probably we can configure what goes there by the flow config.
+      model.transit(
+        transition.transition, true,
+        { ...previous, ...req?.params, ...req?.query } as Record<string, string>
+      )
+
+      let redirectTo: ClientModule<string>
+      // @TODO Properly use target service - as a way to build the redirect URL
+      if (step.service === TARGET_SERVICE) {
+        context.registerModule(module(
+          route(REHACK_MOD, DISPATCHER_PATH, frontend({ service: model.state().service })), stab
+        ))
+        redirectTo = context.module<ClientModule<string>>(REHACK_MOD)
+        await redirectTo.resolve()
+        step.module = REHACK_MOD
+      } else {
+        redirectTo = context.module<ClientModule>(step.module)
+      }
+
+      const [url] = await redirectTo.call<string>(req)
+
+      if (url.startsWith('http')) {
+        await service.proceed(req)
+      } else {
+        await nav.navigate(redirectTo, req)
+      }
+    },
+
+    persist: async () => {
+      if (context.hasResource(FLOW_STATE)) {
+        const resource = context.resource<StateResource>(FLOW_STATE)
+        const _state = model.state()
+        await resource.save({ ..._state, id: FLOW_STATE })
+
+        return true
+      }
+
+      return false
+    }
+  }
+
+  return _client
+}

package/src/consts.ts

@@ -0,0 +1,6 @@
+
+export const DEFAULT_ALIAS = 'flow'
+
+export const FLOW_STATE = 'state:flow'
+
+export const REHACK_MOD = '__redirect'

package/src/index.ts

@@ -0,0 +1,4 @@
+export type * from './types.js'
+export * from './consts.js'
+export * from './client.js'
+export * from './service.js'

package/src/service.ts

@@ -0,0 +1,114 @@
+import { assertContext, createLazyService } from '@owlmeans/context'
+import type { ConfigRecord } from '@owlmeans/context'
+import { DEFAULT_ALIAS } from './consts.js'
+import { DEFAULT_ALIAS as CONFIG_RESOURCE, fromConfigRecord } from '@owlmeans/config'
+import type { ConfigResource } from '@owlmeans/config'
+import type { FlowService, ResolvePair } from './types.js'
+import type { Flow, FlowConfigRecord, WithFlowConfig } from '@owlmeans/flow'
+import { FLOW_RECORD, FlowUnsupported, makeFlowModel, STD_AUTH_FLOW, UnknownFlow } from '@owlmeans/flow'
+
+export const makeBasicFlowService = (alias: string = DEFAULT_ALIAS): FlowService => {
+  const location = `flow-service:${alias}`
+  const pair: ResolvePair = {
+    resolve: () => { },
+    reject: () => { }
+  }
+
+  const flows: { [key: string]: Flow } = {}
+
+  const service: FlowService = createLazyService<FlowService>(alias, {
+    flow: null,
+
+    supplied: new Promise<boolean>((resolve, reject) => {
+      pair.resolve = resolve
+      pair.reject = reject
+    }),
+
+    state: async () => {
+      await service.supplied
+
+      return service.flow
+    },
+
+    resolvePair: () => pair,
+
+    config: () => {
+      const ctx = assertContext(service.ctx, location)
+      return (ctx.cfg as WithFlowConfig).flowConfig ?? {}
+    },
+
+    begin: async (slug, from) => {
+      slug = slug ?? service.config().defaultFlow ?? STD_AUTH_FLOW
+      service.flow = await makeFlowModel(slug, service.provideFlow)
+
+      service.supplied = Promise.resolve(true)
+
+      return service.flow.enter(from)
+    },
+
+    load: async (state) => {
+      service.flow = await makeFlowModel(state, service.provideFlow)
+      
+      service.supplied = Promise.resolve(true)
+
+      return service.flow
+    },
+
+    provideFlow: async slug => {
+      if (flows[slug] == null) {
+        throw new UnknownFlow(slug)
+      }
+      return flows[slug]
+    },
+
+    proceed: async () => {
+      throw new FlowUnsupported('service.proceed')
+    }
+  }, service => async () => {
+    const ctx = assertContext(service.ctx, location)
+    const flowCfg = service.config()
+
+    // @TODO Put it into some configuration and make it more flexible
+    const configRes = ctx.resource<ConfigResource>(CONFIG_RESOURCE)
+    const flowConfigs = await configRes.list({ recordType: FLOW_RECORD })
+    await Promise.all(flowConfigs.items.map(
+      item => fromConfigRecord<ConfigRecord, FlowConfigRecord>(item)
+    ).map(async flow => {
+      Object.values(flow.steps).forEach(step => {
+        if (step.service.startsWith('$')) {
+          const service = flowCfg.services?.[step.service.substring(1)]
+          if (service != null) {
+            step.service = service
+          }
+        }
+        if (step.module != null && step.module.startsWith('$')) {
+          const module = flowCfg.modules?.[step.module.substring(1)]
+          if (module != null) {
+            step.module = module
+          }
+        }
+
+        if (step.path != null && step.path.startsWith('$')) {
+          const path = flowCfg.pathes?.[step.path.substring(1)]
+          if (path != null) {
+            step.path = path
+          }
+        }
+      })
+
+      flows[flow.flow] = {
+        ...flow, config: flowCfg, prefabs: Object.fromEntries(await Promise.all(
+          Object.values(flow.steps).filter(step => step.initial === true)
+            .map(async step => {
+              const state = await makeFlowModel(flow)
+              return [step.step, state.enter(step.step).serialize()]
+            })
+        ))
+      }
+    }))
+
+    service.initialized = true
+  })
+
+  return service
+}

package/src/types.ts

@@ -0,0 +1,45 @@
+
+import type { LazyService } from '@owlmeans/context'
+import type { FlowConfig, FlowModel, FlowProvider, FlowState, FlowTransition } from '@owlmeans/flow'
+import type { AbstractRequest } from '@owlmeans/module'
+import type { ResourceRecord } from '@owlmeans/resource'
+import type { ResolvedServiceRoute } from '@owlmeans/route'
+import type { ClientResource } from '@owlmeans/client-resource'
+
+export interface FlowService extends LazyService {
+  supplied: Promise<boolean>
+
+  flow: FlowModel | null
+
+  state: () => Promise<FlowModel | null>
+
+  resolvePair: () => ResolvePair
+
+  config: () => FlowConfig
+
+  begin: (slug?: string, from?: string) => Promise<FlowModel>
+
+  load: (flow: string) => Promise<FlowModel>
+
+  provideFlow: FlowProvider
+
+  proceed: (req?: Partial<AbstractRequest>, dryRun?: boolean) => Promise<string>
+}
+
+export interface ResolvePair {
+  resolve: (val: boolean) => void,
+  reject: (err: Error) => void
+}
+
+export interface FlowClient {
+  boot: (target: string | null, from?: string) => Promise<FlowClient>
+  setup: (flow: FlowModel) => FlowClient
+  flow: () => FlowModel
+  service: () => ResolvedServiceRoute
+  proceed: (transiation: FlowTransition, req?: Partial<AbstractRequest>) => Promise<void>
+  persist: () => Promise<boolean>
+}
+
+export interface StateRecord extends ResourceRecord, FlowState {}
+
+export interface StateResource extends ClientResource<StateRecord> {}