@owlmeans/client-flow 0.1.2 → 0.1.4

package/README.md

@@ -1,877 +1,68 @@
 # @owlmeans/client-flow
 
-Client-side configurable user flow management library for OwlMeans Common applications. This package provides a comprehensive system for implementing complex user workflows, authentication flows, and multi-step processes in React applications with state persistence and navigation integration.
+Client-side flow orchestration service for managing multi-step workflows in browser environments.
 
 ## Overview
 
-The `@owlmeans/client-flow` package extends the base `@owlmeans/flow` package with client-specific functionality. It provides:
-
-- **Client Flow Management**: Complete client-side implementation of configurable user flows
-- **State Persistence**: Automatic flow state persistence across browser sessions
-- **Navigation Integration**: Seamless integration with React Router navigation
-- **Authentication Flows**: Pre-built authentication and authorization workflows
-- **Service Integration**: Integration with OwlMeans service and module systems
-- **React Components**: Flow-aware components and hooks for React applications
-- **Configuration Management**: Dynamic flow configuration from external sources
-- **Error Handling**: Robust error handling and recovery mechanisms
-
-This package is part of the OwlMeans flow management quadra:
-- **@owlmeans/flow**: Common flow interfaces and utilities
-- **@owlmeans/client-flow**: Client-side flow implementation *(this package)*
-- **@owlmeans/web-flow**: Web-specific flow components and utilities
-- **@owlmeans/server-flow**: Server-side flow processing
+- `makeBasicFlowService(alias?)` — creates a flow service for context registration
+- `createFlowClient(context, nav)` — creates a `FlowClient` bound to the app context and navigator
+- `FlowService` / `FlowClient` — interfaces for flow state management and step transitions
+- Used by `@owlmeans/web-flow` to drive navigation through workflow steps
 
 ## Installation
 
 ```bash
-npm install @owlmeans/client-flow react
+bun add @owlmeans/client-flow
 ```
 
-## Core Concepts
-
-### Flow Models
-Flows are state machines that guide users through multi-step processes. Each flow consists of steps, transitions, and conditions that determine the user's path.
-
-### Flow States
-Flow states represent the current position in a workflow and are automatically persisted to survive browser sessions and page reloads.
-
-### Flow Service
-The central service that manages flow lifecycle, state transitions, and integration with other application services.
-
-### Flow Client
-A client-side wrapper that provides an easy-to-use interface for flow operations with navigation integration.
-
-## API Reference
+## Usage
 
-### Factory Functions
-
-#### `makeBasicFlowService(alias?: string): FlowService`
-
-Creates a flow service instance for managing client-side flows.
+Register the flow service in context setup:
 
 ```typescript
 import { makeBasicFlowService } from '@owlmeans/client-flow'
 
-const flowService = makeBasicFlowService('user-flows')
-```
-
-**Parameters:**
-- `alias`: string (optional) - Service alias for registration, defaults to 'flow'
-
-**Returns:** FlowService instance ready for registration with context
-
-#### `createFlowClient<C, T>(context: T, nav: Navigator): FlowClient`
-
-Creates a flow client that integrates flows with navigation and context.
-
-```typescript
-import { createFlowClient } from '@owlmeans/client-flow'
-import { useContext, useNavigate } from '@owlmeans/client'
-
-const context = useContext()
-const navigator = useNavigate()
-const flowClient = createFlowClient(context, navigator)
-```
-
-**Parameters:**
-- `context`: T - Application context with flow service
-- `nav`: Navigator - Navigation service for routing integration
-
-**Returns:** FlowClient instance for flow operations
-
-### Core Interfaces
-
-#### `FlowService`
-
-Main service interface for flow management and lifecycle operations.
-
-```typescript
-interface FlowService extends LazyService {
-  supplied: Promise<boolean>                          // Flow availability promise
-  flow: FlowModel | null                             // Current active flow
-  
-  // Flow operations
-  state(): Promise<FlowModel | null>                 // Get current flow state
-  begin(slug?: string, from?: string): Promise<FlowModel>  // Start new flow
-  load(flow: string): Promise<FlowModel>             // Load existing flow
-  proceed(req?, dryRun?): Promise<string>            // Proceed to next step
-  
-  // Configuration and providers
-  config(): FlowConfig                               // Get flow configuration
-  provideFlow: FlowProvider                          // Flow provider function
-  resolvePair(): ResolvePair                         // Promise resolution pair
-}
-```
-
-#### `FlowClient`
-
-Client-side flow wrapper with navigation and persistence integration.
-
-```typescript
-interface FlowClient {
-  boot(target?: string, from?: string): Promise<FlowClient>     // Initialize flow client
-  setup(flow: FlowModel): FlowClient                            // Setup with existing flow
-  flow(): FlowModel                                             // Get current flow model
-  service(): ResolvedServiceRoute                               // Get target service route
-  proceed(transition: FlowTransition, req?): Promise<void>      // Execute transition
-  persist(): Promise<boolean>                                   // Persist current state
-}
-```
-
-#### `StateRecord`
-
-Interface for flow state persistence records.
-
-```typescript
-interface StateRecord extends ResourceRecord, FlowState {
-  id: string                    // Record identifier
-  flow: string                  // Flow type identifier
-  step: string                  // Current step identifier
-  service: string               // Target service
-  data: any                     // Flow-specific data
-  // ... other FlowState properties
-}
-```
-
-#### `StateResource`
-
-Resource interface for managing flow state persistence.
-
-```typescript
-interface StateResource extends ClientResource<StateRecord> {
-  // Inherits all standard resource methods for CRUD operations
-}
-```
-
-### Flow Service Methods Detailed Reference
-
-#### `state(): Promise<FlowModel | null>`
-
-**Purpose**: Retrieves the current active flow model
-
-**Behavior**:
-- Waits for flow service to be supplied/ready
-- Returns the currently active flow or null if no flow is active
-- Used to check flow status before operations
-
-**Usage**: Checking if a flow is currently active
-
-```typescript
-const flowService = context.service<FlowService>('flow')
-
-const currentFlow = await flowService.state()
-if (currentFlow) {
-  console.log('Active flow:', currentFlow.name)
-  console.log('Current step:', currentFlow.step())
-} else {
-  console.log('No active flow')
-}
+context.registerService(makeBasicFlowService())
 ```
 
-#### `begin(slug?: string, from?: string): Promise<FlowModel>`
-
-**Purpose**: Starts a new flow with the specified configuration
-
-**Behavior**:
-- Creates a new flow model based on the slug
-- Sets the service as supplied/ready
-- Enters the flow from the specified step or initial step
-- Returns the active flow model
-
-**Usage**: Starting authentication, registration, or other workflows
-
-**Parameters**:
-- `slug`: string (optional) - Flow identifier, defaults to config.defaultFlow or STD_AUTH_FLOW
-- `from`: string (optional) - Starting step, defaults to flow's initial step
+Create a flow client in a component or hook:
 
 ```typescript
-const flowService = context.service<FlowService>('flow')
+import { createFlowClient, DEFAULT_ALIAS as FLOW_ALIAS } from '@owlmeans/client-flow'
+import type { FlowService, FlowClient } from '@owlmeans/client-flow'
 
-// Start default authentication flow
-const authFlow = await flowService.begin()
-
-// Start specific flow from specific step
-const registrationFlow = await flowService.begin('user-registration', 'email-verification')
-
-// Start flow with default slug
-const defaultFlow = await flowService.begin('custom-onboarding')
-```
-
-#### `load(flow: string): Promise<FlowModel>`
-
-**Purpose**: Loads and activates a flow from serialized state
-
-**Behavior**:
-- Recreates flow model from serialized state string
-- Sets the service as supplied/ready
-- Restores flow to its previous state
-- Returns the restored flow model
-
-**Usage**: Restoring flows from persistent storage
-
-```typescript
-const flowService = context.service<FlowService>('flow')
+const service = context.service<FlowService>(FLOW_ALIAS)
+await service.ready()
 
-// Load flow from saved state
-const savedFlowState = localStorage.getItem('flow-state')
-if (savedFlowState) {
-  const restoredFlow = await flowService.load(savedFlowState)
-  console.log('Flow restored to step:', restoredFlow.step())
-}
+const client = await createFlowClient(context, nav).boot(target)
+// Navigate to next step
+await client.proceed(transition, request)
 ```
 
-#### `proceed(req?: Partial<AbstractRequest>, dryRun?: boolean): Promise<string>`
+## API
 
-**Purpose**: Advances the flow to the next step based on conditions
+### `makeBasicFlowService(alias?): FlowService`
 
-**Behavior**:
-- Evaluates current step's transitions and conditions
-- Moves to the next appropriate step
-- Throws FlowUnsupported error (not implemented in basic service)
-- Should be overridden in specific implementations
+Creates the flow service. `alias` defaults to `DEFAULT_ALIAS` (`'flow'`).
 
-**Usage**: Advancing through flow steps
-
-**Note**: The basic service throws `FlowUnsupported` - this should be implemented by specific flow implementations
-
-```typescript
-// This would be implemented in a specific flow service
-const nextStep = await flowService.proceed({
-  body: { userInput: 'some-data' }
-})
-```
-
-#### `config(): FlowConfig`
-
-**Purpose**: Retrieves the current flow configuration
-
-**Behavior**:
-- Accesses flow configuration from context
-- Returns default empty config if not configured
-- Used for flow behavior customization
-
-**Usage**: Accessing flow settings and configuration
-
-```typescript
-const flowService = context.service<FlowService>('flow')
-
-const config = flowService.config()
-console.log('Default flow:', config.defaultFlow)
-console.log('Available services:', config.services)
-```
+### `createFlowClient(context, nav): FlowClient`
 
-### Flow Client Methods Detailed Reference
-
-#### `boot(target?: string, from?: string): Promise<FlowClient>`
-
-**Purpose**: Initializes the flow client with optional target service and starting point
-
-**Behavior**:
-- Waits for flow service to be ready
-- Attempts to restore flow from persistent storage
-- Creates new flow if no saved state exists
-- Sets target service if provided
-- Returns the initialized client
-
-**Usage**: Starting the flow system in your application
-
-```typescript
-const flowClient = createFlowClient(context, navigator)
-
-// Boot with specific target service
-await flowClient.boot('user-dashboard', 'login-step')
-
-// Boot with default behavior
-await flowClient.boot()
-
-// Boot without target, from saved state
-await flowClient.boot(null)
-```
-
-#### `setup(flow: FlowModel): FlowClient`
-
-**Purpose**: Configures the client with an existing flow model
-
-**Behavior**:
-- Sets the provided flow as the active flow
-- Returns the client for method chaining
-- Used when you already have a flow model
-
-**Usage**: Using pre-configured flow models
-
-```typescript
-const existingFlow = await flowService.begin('checkout-flow')
-const flowClient = createFlowClient(context, navigator)
-  .setup(existingFlow)
-```
-
-#### `flow(): FlowModel`
-
-**Purpose**: Returns the current active flow model
-
-**Behavior**: Direct access to the underlying flow model
-
-**Usage**: Accessing flow state and methods
-
-```typescript
-const currentFlow = flowClient.flow()
-console.log('Current step:', currentFlow.step())
-console.log('Flow data:', currentFlow.data())
-```
-
-#### `service(): ResolvedServiceRoute`
-
-**Purpose**: Returns the resolved service route for the target service
-
-**Behavior**: 
-- Resolves the target service from the context
-- Returns route information for navigation
-
-**Usage**: Getting service routing information
-
-```typescript
-const serviceRoute = flowClient.service()
-console.log('Target service:', serviceRoute.service)
-console.log('Service path:', serviceRoute.path)
-```
-
-#### `proceed(transition: FlowTransition, req?: Partial<AbstractRequest>): Promise<void>`
-
-**Purpose**: Executes a flow transition with optional request data
-
-**Behavior**:
-- Executes the specified transition
-- Passes request data to the transition handler
-- Updates flow state based on transition result
-- Handles navigation if required
-
-**Usage**: Moving between flow steps
-
-```typescript
-await flowClient.proceed('next', {
-  body: { formData: userData }
-})
-
-await flowClient.proceed('back')
-
-await flowClient.proceed('submit', {
-  params: { id: userId }
-})
-```
-
-#### `persist(): Promise<boolean>`
-
-**Purpose**: Saves the current flow state to persistent storage
-
-**Behavior**:
-- Serializes current flow state
-- Saves to flow state resource
-- Returns success status
-
-**Usage**: Saving flow progress
-
-```typescript
-const saved = await flowClient.persist()
-if (saved) {
-  console.log('Flow state saved successfully')
-} else {
-  console.log('Failed to save flow state')
-}
-```
-
-### Constants
-
-#### `DEFAULT_ALIAS`
-Default flow service alias (`'flow'`).
-
-#### `FLOW_STATE`
-Resource identifier for flow state persistence (`'state:flow'`).
-
-#### `REHACK_MOD`
-Internal module identifier for redirects (`'__redirect'`).
-
-## Usage Examples
-
-### Basic Flow Setup
-
-```typescript
-import { makeBasicFlowService, createFlowClient } from '@owlmeans/client-flow'
-import { makeClientContext, useContext } from '@owlmeans/client'
-
-// Create context with flow service
-const context = makeClientContext(config)
-const flowService = makeBasicFlowService()
-context.registerService(flowService)
-
-// Initialize context
-await context.configure().init()
-
-// Create flow client
-function MyFlowComponent() {
-  const context = useContext()
-  const navigator = useNavigate()
-  
-  const [flowClient, setFlowClient] = useState(null)
-  
-  useEffect(() => {
-    const initFlow = async () => {
-      const client = createFlowClient(context, navigator)
-      await client.boot('user-onboarding')
-      setFlowClient(client)
-    }
-    
-    initFlow()
-  }, [])
-  
-  return flowClient ? <FlowRenderer client={flowClient} /> : <div>Loading...</div>
-}
-```
-
-### Authentication Flow Implementation
-
-```typescript
-import { makeBasicFlowService } from '@owlmeans/client-flow'
-import { STD_AUTH_FLOW } from '@owlmeans/flow'
-
-// Setup authentication flow
-const context = makeClientContext({
-  service: 'my-app',
-  // ... other config
-  flowConfig: {
-    defaultFlow: STD_AUTH_FLOW,
-    services: {
-      auth: 'authentication-service',
-      dashboard: 'user-dashboard'
-    },
-    modules: {
-      login: 'auth-login-module',
-      register: 'auth-register-module'
-    }
-  }
-})
-
-const flowService = makeBasicFlowService('auth-flow')
-context.registerService(flowService)
-
-// Use in component
-function AuthFlow() {
-  const context = useContext()
-  const navigator = useNavigate()
-  const [currentStep, setCurrentStep] = useState(null)
-  
-  useEffect(() => {
-    const startAuthFlow = async () => {
-      const client = createFlowClient(context, navigator)
-      await client.boot('dashboard', 'login')
-      
-      const flow = client.flow()
-      setCurrentStep(flow.step())
-    }
-    
-    startAuthFlow()
-  }, [])
-  
-  const handleLogin = async (credentials) => {
-    const client = createFlowClient(context, navigator)
-    await client.proceed('authenticate', {
-      body: credentials
-    })
-    
-    // Persist progress
-    await client.persist()
-    
-    // Update current step
-    setCurrentStep(client.flow().step())
-  }
-  
-  return (
-    <div>
-      <h2>Authentication Flow</h2>
-      <p>Current Step: {currentStep}</p>
-      {currentStep === 'login' && <LoginForm onSubmit={handleLogin} />}
-      {currentStep === 'verified' && <Navigate to="/dashboard" />}
-    </div>
-  )
-}
-```
-
-### Multi-Step Registration Flow
-
-```typescript
-interface RegistrationData {
-  personalInfo: { name: string; email: string }
-  preferences: { theme: string; notifications: boolean }
-  verification: { code: string }
-}
-
-function RegistrationFlow() {
-  const context = useContext()
-  const navigator = useNavigate()
-  const [flowClient, setFlowClient] = useState<FlowClient | null>(null)
-  const [registrationData, setRegistrationData] = useState<Partial<RegistrationData>>({})
-  
-  useEffect(() => {
-    const initRegistration = async () => {
-      const client = createFlowClient(context, navigator)
-      await client.boot('user-registration', 'personal-info')
-      setFlowClient(client)
-    }
-    
-    initRegistration()
-  }, [])
-  
-  const proceedToNext = async (stepData: any) => {
-    if (!flowClient) return
-    
-    // Update registration data
-    const updatedData = { ...registrationData, ...stepData }
-    setRegistrationData(updatedData)
-    
-    // Proceed to next step
-    await flowClient.proceed('next', {
-      body: updatedData
-    })
-    
-    // Persist state
-    await flowClient.persist()
-  }
-  
-  const getCurrentStep = () => {
-    return flowClient?.flow().step() || 'loading'
-  }
-  
-  const renderCurrentStep = () => {
-    const step = getCurrentStep()
-    
-    switch (step) {
-      case 'personal-info':
-        return <PersonalInfoForm onSubmit={proceedToNext} />
-      case 'preferences':
-        return <PreferencesForm onSubmit={proceedToNext} />
-      case 'verification':
-        return <VerificationForm onSubmit={proceedToNext} />
-      case 'complete':
-        return <RegistrationComplete />
-      default:
-        return <div>Loading...</div>
-    }
-  }
-  
-  return (
-    <div>
-      <h2>Registration Flow</h2>
-      <div>Step: {getCurrentStep()}</div>
-      {renderCurrentStep()}
-    </div>
-  )
-}
-```
-
-### Flow State Persistence
-
-```typescript
-import { appendClientResource } from '@owlmeans/client-resource'
-import { FLOW_STATE } from '@owlmeans/client-flow'
-
-// Setup flow state resource
-appendClientResource(context, FLOW_STATE)
-
-class FlowStateManager {
-  constructor(private context: ClientContext) {}
-  
-  async saveFlowState(flowClient: FlowClient): Promise<boolean> {
-    try {
-      const flow = flowClient.flow()
-      const stateResource = this.context.resource<StateResource>(FLOW_STATE)
-      
-      await stateResource.save({
-        id: FLOW_STATE,
-        flow: flow.name,
-        step: flow.step(),
-        service: flowClient.service().service,
-        data: flow.data(),
-        timestamp: new Date()
-      })
-      
-      return true
-    } catch (error) {
-      console.error('Failed to save flow state:', error)
-      return false
-    }
-  }
-  
-  async loadFlowState(): Promise<StateRecord | null> {
-    try {
-      const stateResource = this.context.resource<StateResource>(FLOW_STATE)
-      return await stateResource.load(FLOW_STATE)
-    } catch (error) {
-      console.error('Failed to load flow state:', error)
-      return null
-    }
-  }
-  
-  async clearFlowState(): Promise<void> {
-    try {
-      const stateResource = this.context.resource<StateResource>(FLOW_STATE)
-      await stateResource.delete(FLOW_STATE)
-    } catch (error) {
-      console.error('Failed to clear flow state:', error)
-    }
-  }
-}
-
-// Usage
-const stateManager = new FlowStateManager(context)
-
-// Auto-save flow state
-const flowClient = createFlowClient(context, navigator)
-await flowClient.boot()
-
-// Save state after each step
-await stateManager.saveFlowState(flowClient)
-
-// Restore on application start
-const savedState = await stateManager.loadFlowState()
-if (savedState) {
-  const flowService = context.service<FlowService>('flow')
-  const restoredFlow = await flowService.begin(savedState.flow)
-  restoredFlow.setState(savedState)
-}
-```
-
-### Custom Flow Service
-
-```typescript
-import { makeBasicFlowService } from '@owlmeans/client-flow'
-
-class CustomFlowService extends makeBasicFlowService('custom') {
-  async proceed(req?: Partial<AbstractRequest>, dryRun?: boolean): Promise<string> {
-    if (!this.flow) {
-      throw new Error('No active flow')
-    }
-    
-    const currentStep = this.flow.step()
-    const transitions = this.flow.transitions()
-    
-    // Custom logic for determining next step
-    let nextStep = 'default'
-    
-    if (req?.body?.action === 'skip') {
-      nextStep = this.findSkipTransition(transitions)
-    } else if (req?.body?.action === 'back') {
-      nextStep = this.findBackTransition(transitions)
-    } else {
-      nextStep = this.findNextTransition(transitions, req)
-    }
-    
-    if (!dryRun) {
-      await this.flow.transition(nextStep, req)
-    }
-    
-    return nextStep
-  }
-  
-  private findNextTransition(transitions: any[], req?: any): string {
-    // Implement custom transition logic
-    return transitions[0]?.target || 'end'
-  }
-  
-  private findSkipTransition(transitions: any[]): string {
-    return transitions.find(t => t.type === 'skip')?.target || 'end'
-  }
-  
-  private findBackTransition(transitions: any[]): string {
-    return transitions.find(t => t.type === 'back')?.target || 'start'
-  }
-}
-
-// Register custom service
-const customFlowService = new CustomFlowService()
-context.registerService(customFlowService)
-```
-
-### Flow-Aware React Hook
-
-```typescript
-import { useState, useEffect } from 'react'
-import { useContext } from '@owlmeans/client'
-
-interface UseFlowResult {
-  flowClient: FlowClient | null
-  currentStep: string | null
-  isLoading: boolean
-  proceed: (action: string, data?: any) => Promise<void>
-  persist: () => Promise<boolean>
-}
-
-export function useFlow(flowType?: string, targetService?: string): UseFlowResult {
-  const context = useContext()
-  const navigator = useNavigate()
-  const [flowClient, setFlowClient] = useState<FlowClient | null>(null)
-  const [currentStep, setCurrentStep] = useState<string | null>(null)
-  const [isLoading, setIsLoading] = useState(true)
-  
-  useEffect(() => {
-    const initFlow = async () => {
-      try {
-        const client = createFlowClient(context, navigator)
-        await client.boot(targetService)
-        
-        if (flowType) {
-          const flowService = context.service<FlowService>('flow')
-          const flow = await flowService.begin(flowType)
-          client.setup(flow)
-        }
-        
-        setFlowClient(client)
-        setCurrentStep(client.flow().step())
-      } catch (error) {
-        console.error('Flow initialization failed:', error)
-      } finally {
-        setIsLoading(false)
-      }
-    }
-    
-    initFlow()
-  }, [flowType, targetService])
-  
-  const proceed = async (action: string, data?: any) => {
-    if (!flowClient) return
-    
-    await flowClient.proceed(action, { body: data })
-    setCurrentStep(flowClient.flow().step())
-  }
-  
-  const persist = async (): Promise<boolean> => {
-    if (!flowClient) return false
-    return await flowClient.persist()
-  }
-  
-  return {
-    flowClient,
-    currentStep,
-    isLoading,
-    proceed,
-    persist
-  }
-}
-
-// Usage in component
-function FlowBasedComponent() {
-  const { currentStep, isLoading, proceed, persist } = useFlow('onboarding', 'dashboard')
-  
-  if (isLoading) {
-    return <div>Initializing flow...</div>
-  }
-  
-  const handleNext = async (data: any) => {
-    await proceed('next', data)
-    await persist()
-  }
-  
-  return (
-    <div>
-      <h3>Current Step: {currentStep}</h3>
-      {currentStep === 'welcome' && <WelcomeStep onNext={handleNext} />}
-      {currentStep === 'setup' && <SetupStep onNext={handleNext} />}
-      {currentStep === 'complete' && <CompleteStep />}
-    </div>
-  )
-}
-```
-
-## Error Handling
-
-The package integrates with the OwlMeans error system and may throw the following errors:
-
-### `FlowUnsupported`
-Thrown when an unsupported flow operation is attempted.
-
-### `UnknownFlow`
-Thrown when trying to access a flow that hasn't been registered.
-
-### `FlowTargetError`
-Thrown when the target service for a flow cannot be resolved.
-
-### `FlowStepMissconfigured`
-Thrown when flow steps are not properly configured.
-
-```typescript
-import { FlowUnsupported, UnknownFlow, FlowTargetError } from '@owlmeans/flow'
-
-const handleFlowError = async () => {
-  try {
-    await flowClient.proceed('invalid-transition')
-  } catch (error) {
-    if (error instanceof FlowUnsupported) {
-      console.error('Flow operation not supported')
-    } else if (error instanceof UnknownFlow) {
-      console.error('Flow not found:', error.message)
-    } else if (error instanceof FlowTargetError) {
-      console.error('Invalid flow target:', error.message)
-    }
-  }
-}
-```
-
-## Integration with Other Packages
-
-### Authentication Integration
-```typescript
-import { makeAuthService } from '@owlmeans/client-auth'
-import { makeBasicFlowService } from '@owlmeans/client-flow'
-
-// Setup authentication flow
-const context = makeClientContext(config)
-const authService = makeAuthService()
-const flowService = makeBasicFlowService()
-
-context.registerService(authService)
-context.registerService(flowService)
-```
-
-### Resource Integration
-```typescript
-import { appendClientResource } from '@owlmeans/client-resource'
-import { FLOW_STATE } from '@owlmeans/client-flow'
-
-// Setup flow state persistence
-appendClientResource(context, FLOW_STATE)
-```
-
-### Navigation Integration
-```typescript
-import { useNavigate } from '@owlmeans/client'
-import { createFlowClient } from '@owlmeans/client-flow'
-
-const navigator = useNavigate()
-const flowClient = createFlowClient(context, navigator)
-```
+Creates a flow client with methods:
+- `boot(target, from?)` — load and initialize flow for a target slug
+- `setup(flow)` — set the current flow model
+- `proceed(transition, req?)` — advance to the next step
+- `persist()` — save flow state
 
-## Best Practices
+### `DEFAULT_ALIAS`
 
-1. **State Persistence**: Always persist flow state for long-running processes
-2. **Error Handling**: Implement comprehensive error handling for flow operations
-3. **Flow Design**: Design flows with clear steps and transition conditions
-4. **Service Integration**: Properly configure target services for flows
-5. **React Integration**: Use hooks for clean React component integration
-6. **Testing**: Test flow transitions and error conditions thoroughly
-7. **Configuration**: Use external configuration for flexible flow behavior
+`'flow'` — the default service alias.
 
-## Dependencies
+### `FLOW_STATE`
 
-This package depends on:
-- `@owlmeans/flow` - Core flow interfaces and utilities
-- `@owlmeans/client-context` - Client context management
-- `@owlmeans/client-module` - Client module system
-- `@owlmeans/client-resource` - Client resource management
-- `@owlmeans/context` - Core context system
-- `react` - React library (peer dependency)
+`'state:flow'` — key used to store flow state in the client resource layer.
 
 ## Related Packages
 
-- [`@owlmeans/flow`](../flow) - Core flow system
-- [`@owlmeans/web-flow`](../web-flow) - Web-specific flow components
-- [`@owlmeans/server-flow`](../server-flow) - Server-side flow processing
-- [`@owlmeans/client-auth`](../client-auth) - Authentication with flow integration
-- [`@owlmeans/client`](../client) - Base React client library
+- [`@owlmeans/flow`](../flow) — `FlowModel`, `FlowConfig`, `FlowTransition` types
+- [`@owlmeans/web-flow`](../web-flow) — React hook (`useFlow`) built on top of `createFlowClient`
+- [`@owlmeans/client-resource`](../client-resource) — used internally to persist flow state

package/build/client.js

@@ -1,4 +1,4 @@
-import { module, stab } from '@owlmeans/client-module';
+import { entrypoint, stab } from '@owlmeans/client-entrypoint';
 import { route, frontend } from '@owlmeans/route';
 import { FlowStepMissconfigured, FlowTargetError, TARGET_SERVICE } from '@owlmeans/flow';
 import { ResilientError } from '@owlmeans/error';
@@ -67,13 +67,13 @@ export const createFlowClient = (context, nav) => {
             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);
+                context.registerEntrypoint(entrypoint(route(REHACK_MOD, DISPATCHER_PATH, frontend({ service: model.state().service })), stab));
+                redirectTo = context.entrypoint(REHACK_MOD);
                 await redirectTo.resolve();
                 step.module = REHACK_MOD;
             }
             else {
-                redirectTo = context.module(step.module);
+                redirectTo = context.entrypoint(step.module);
             }
             const [url] = await redirectTo.call(req);
             if (url.startsWith('http')) {

package/build/client.js.map

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

package/build/types.d.ts

@@ -1,6 +1,6 @@
 import type { LazyService } from '@owlmeans/context';
 import type { FlowConfig, FlowModel, FlowProvider, FlowState, FlowTransition } from '@owlmeans/flow';
-import type { AbstractRequest } from '@owlmeans/module';
+import type { AbstractRequest } from '@owlmeans/entrypoint';
 import type { ResourceRecord } from '@owlmeans/resource';
 import type { ResolvedServiceRoute } from '@owlmeans/route';
 import type { ClientResource } from '@owlmeans/client-resource';

package/build/types.d.ts.map

@@ -1 +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"}
+{"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,sBAAsB,CAAA;AAC3D,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/client-flow",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -21,26 +21,27 @@
     }
   },
   "dependencies": {
-    "@owlmeans/auth-common": "^0.1.2",
-    "@owlmeans/client": "^0.1.2",
-    "@owlmeans/client-context": "^0.1.2",
-    "@owlmeans/client-module": "^0.1.2",
-    "@owlmeans/client-resource": "^0.1.2",
-    "@owlmeans/config": "^0.1.2",
-    "@owlmeans/context": "^0.1.2",
-    "@owlmeans/error": "^0.1.2",
-    "@owlmeans/flow": "^0.1.2",
-    "@owlmeans/module": "^0.1.2",
-    "@owlmeans/resource": "^0.1.2",
-    "@owlmeans/route": "^0.1.2"
+    "@owlmeans/auth-common": "^0.1.4",
+    "@owlmeans/client": "^0.1.4",
+    "@owlmeans/client-context": "^0.1.4",
+    "@owlmeans/client-entrypoint": "^0.1.4",
+    "@owlmeans/client-resource": "^0.1.4",
+    "@owlmeans/config": "^0.1.4",
+    "@owlmeans/context": "^0.1.4",
+    "@owlmeans/error": "^0.1.4",
+    "@owlmeans/flow": "^0.1.4",
+    "@owlmeans/entrypoint": "^0.1.4",
+    "@owlmeans/resource": "^0.1.4",
+    "@owlmeans/route": "^0.1.4"
   },
   "peerDependencies": {
     "react": "*"
   },
   "devDependencies": {
+    "@owlmeans/dep-config": "workspace:*",
     "nodemon": "^3.1.11",
     "npm-check": "^6.0.1",
-    "typescript": "^5.8.3"
+    "typescript": "^6.0.2"
   },
   "publishConfig": {
     "access": "public"

package/src/client.ts

@@ -1,7 +1,7 @@
 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 { ClientEntrypoint } from '@owlmeans/client-entrypoint'
+import { entrypoint, stab } from '@owlmeans/client-entrypoint'
 import type { ResolvedServiceRoute } from '@owlmeans/route'
 import { route, frontend } from '@owlmeans/route'
 import { FlowStepMissconfigured, FlowTargetError, TARGET_SERVICE } from '@owlmeans/flow'
@@ -87,17 +87,17 @@ export const createFlowClient = <C extends ClientConfig, T extends ClientContext
         { ...previous, ...req?.params, ...req?.query } as Record<string, string>
       )
 
-      let redirectTo: ClientModule<string>
+      let redirectTo: ClientEntrypoint<string>
       // @TODO Properly use target service - as a way to build the redirect URL
       if (step.service === TARGET_SERVICE) {
-        context.registerModule(module(
+        context.registerEntrypoint(entrypoint(
           route(REHACK_MOD, DISPATCHER_PATH, frontend({ service: model.state().service })), stab
         ))
-        redirectTo = context.module<ClientModule<string>>(REHACK_MOD)
+        redirectTo = context.entrypoint<ClientEntrypoint<string>>(REHACK_MOD)
         await redirectTo.resolve()
         step.module = REHACK_MOD
       } else {
-        redirectTo = context.module<ClientModule>(step.module)
+        redirectTo = context.entrypoint<ClientEntrypoint>(step.module)
       }
 
       const [url] = await redirectTo.call<string>(req)

package/src/types.ts

@@ -1,7 +1,7 @@
 
 import type { LazyService } from '@owlmeans/context'
 import type { FlowConfig, FlowModel, FlowProvider, FlowState, FlowTransition } from '@owlmeans/flow'
-import type { AbstractRequest } from '@owlmeans/module'
+import type { AbstractRequest } from '@owlmeans/entrypoint'
 import type { ResourceRecord } from '@owlmeans/resource'
 import type { ResolvedServiceRoute } from '@owlmeans/route'
 import type { ClientResource } from '@owlmeans/client-resource'

package/tsconfig.json

@@ -1,15 +1,10 @@
 {
   "extends": [
-    "../tsconfig.default.json"
+    "@owlmeans/dep-config/tsconfig.base.json"
   ],
   "compilerOptions": {
-    "rootDir": "./src/", /* Specify the root folder within your source files. */
-    "outDir": "./build/", /* Specify an output folder for all emitted files. */
-    "moduleResolution": "Bundler"
+    "rootDir": "./src/",
+    "outDir": "./build/"
   },
-  "exclude": [
-    "./dist/**/*",
-    "./build/**/*",
-    "./*.ts"
-  ]
-}
+  "exclude": ["./dist/**/*", "./build/**/*", "./*.ts"]
+}

package/build/helper.d.ts

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

package/build/helper.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,eAAO,MAAM,eAAe,GAC1B,CAAC,SAAS,YAAY,GAAG,YAAY,EACrC,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EAC7C,SAAS,CAAC,KAAG,aAA6C,CAAA"}

package/build/helper.js

@@ -1,3 +0,0 @@
-import { FLOW_STATE } from "./consts.js";
-export const getFlowResource = (context) => context.resource(FLOW_STATE);
-//# sourceMappingURL=helper.js.map

package/build/helper.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"helper.js","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAGxC,MAAM,CAAC,MAAM,eAAe,GAAG,CAG7B,OAAU,EAAiB,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA"}