@owlmeans/client-context 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 OwlMeans Common — Fullstack typescript framework
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,471 @@
+# @owlmeans/client-context
+
+Client-side context management for OwlMeans Common applications. This package extends the basic context system with client-specific functionality including service routing, API client integration, and configuration management designed for frontend applications.
+
+## Overview
+
+The `@owlmeans/client-context` package provides client-side context management for the OwlMeans ecosystem, offering:
+
+- **Client Context Factory**: Creates contexts specifically configured for frontend applications
+- **Service Route Management**: Manages service routes and API endpoints for client-server communication
+- **API Client Integration**: Automatic integration with the OwlMeans API client system
+- **Configuration Management**: Client-specific configuration with service definitions and i18n support
+- **Frontend Context Utilities**: Helper functions for managing client application contexts
+
+This package follows the OwlMeans "quadra" pattern as a client-side implementation extending the basic `@owlmeans/context` package.
+
+## Installation
+
+```bash
+npm install @owlmeans/client-context
+```
+
+## Dependencies
+
+This package requires and integrates with:
+- `@owlmeans/context`: Base context management system
+- `@owlmeans/client-config`: Client configuration management
+- `@owlmeans/api`: API client integration
+- `@owlmeans/route`: Service route definitions
+- `@owlmeans/i18n`: Internationalization support
+
+## Core Concepts
+
+### Client Context
+
+A client context is a specialized application context that manages client-side dependencies, service routes, and API communication. It extends the basic context with client-specific functionality.
+
+### Service Routes
+
+Service routes define how the client communicates with backend services, including endpoint definitions, authentication requirements, and communication protocols.
+
+### Configuration Management
+
+Client contexts handle configuration specific to frontend applications, including service definitions, internationalization settings, and client-specific parameters.
+
+## API Reference
+
+### Types
+
+#### `ClientConfig`
+Configuration interface for client contexts extending BasicClientConfig.
+
+```typescript
+interface ClientConfig extends BasicClientConfig {
+  services: Record<string, CommonServiceRoute>  // Service route definitions
+  i18n?: I18nConfig                            // Internationalization configuration
+}
+```
+
+#### `ClientContext<C>`
+Main client context interface extending BasicContext with client-specific functionality.
+
+```typescript
+interface ClientContext<C extends ClientConfig = ClientConfig> extends BasicContext<C>, ConfigResourceAppend {
+  serviceRoute: (alias: string, makeDefault?: boolean) => CommonServiceRoute
+}
+```
+
+**Methods:**
+- **`serviceRoute(alias: string, makeDefault?: boolean): CommonServiceRoute`**: Retrieves service route by alias and optionally sets as default
+
+### Factory Functions
+
+#### `makeClientContext<C, T>(cfg: C): T`
+
+Creates a client context instance with automatic API client integration.
+
+**Parameters:**
+- `cfg`: Client configuration object
+
+**Returns:** ClientContext instance
+
+**Features:**
+- Automatically integrates API client
+- Sets up service route management
+- Configures context for frontend operation
+
+**Example:**
+```typescript
+import { makeClientContext, config } from '@owlmeans/client-context'
+
+// Create client configuration
+const clientConfig = config('my-app', {
+  services: {
+    'user-service': {
+      alias: 'user-service',
+      route: {
+        alias: 'users',
+        path: '/api/users',
+        service: 'user-service'
+      }
+    }
+  }
+})
+
+// Create client context
+const context = makeClientContext(clientConfig)
+
+await context.configure().init()
+
+// Access service route
+const userService = context.serviceRoute('user-service')
+```
+
+#### `config<C>(service: string, cfg?: Partial<C>): C`
+
+Creates a client configuration with default frontend settings.
+
+**Parameters:**
+- `service`: Service name identifier
+- `cfg` (optional): Additional configuration options
+
+**Returns:** ClientConfig object configured for frontend
+
+**Example:**
+```typescript
+import { config } from '@owlmeans/client-context'
+
+const clientConfig = config('frontend-app', {
+  layer: Layer.Service,
+  services: {
+    'api': {
+      alias: 'api',
+      route: {
+        alias: 'api',
+        path: '/api',
+        service: 'backend'
+      }
+    }
+  },
+  i18n: {
+    defaultLng: 'en',
+    defaultNs: 'translation'
+  }
+})
+```
+
+### Service Route Management
+
+#### `serviceRoute(alias: string, makeDefault?: boolean): CommonServiceRoute`
+
+Retrieves and manages service routes for API communication.
+
+**Parameters:**
+- `alias`: Service route alias
+- `makeDefault` (optional): Whether to mark this route as default
+
+**Returns:** CommonServiceRoute object
+
+**Throws:** `SyntaxError` if service route not found
+
+**Example:**
+```typescript
+// Get service route
+const apiRoute = context.serviceRoute('api')
+
+// Set as default service
+const defaultRoute = context.serviceRoute('main-api', true)
+
+// Use route for API calls
+const apiClient = context.service('api-client')
+await apiClient.call(apiRoute, 'users', { method: 'GET' })
+```
+
+### Constants
+
+#### `PLUGINS`
+Constant for plugin configuration.
+
+```typescript
+const PLUGINS = 'plugins'
+```
+
+## Usage Examples
+
+### Basic Client Context Setup
+
+```typescript
+import { makeClientContext, config } from '@owlmeans/client-context'
+import { Layer } from '@owlmeans/context'
+
+// Create configuration with service routes
+const clientConfig = config('web-app', {
+  layer: Layer.User,
+  services: {
+    'auth-service': {
+      alias: 'auth',
+      route: {
+        alias: 'auth',
+        path: '/api/auth',
+        service: 'auth-backend'
+      }
+    },
+    'user-service': {
+      alias: 'users',
+      route: {
+        alias: 'users',
+        path: '/api/users',
+        service: 'user-backend'
+      }
+    }
+  }
+})
+
+// Create and initialize context
+const context = makeClientContext(clientConfig)
+await context.configure().init()
+
+// Access services and routes
+const authRoute = context.serviceRoute('auth-service')
+const userRoute = context.serviceRoute('user-service')
+```
+
+### API Integration
+
+```typescript
+// Context automatically includes API client
+const apiClient = context.service('api-client')
+
+// Use service routes for API calls
+const authRoute = context.serviceRoute('auth-service')
+const response = await apiClient.call(authRoute, 'login', {
+  method: 'POST',
+  body: { username: 'user', password: 'pass' }
+})
+
+// Handle different services
+const userRoute = context.serviceRoute('user-service', true) // Set as default
+const users = await apiClient.call(userRoute, 'list', { method: 'GET' })
+```
+
+### Internationalization Integration
+
+```typescript
+const clientConfig = config('i18n-app', {
+  services: { /* service definitions */ },
+  i18n: {
+    defaultLng: 'en',
+    defaultNs: 'app',
+    resources: {
+      en: {
+        app: {
+          title: 'My Application',
+          welcome: 'Welcome to our app'
+        }
+      }
+    }
+  }
+})
+
+const context = makeClientContext(clientConfig)
+await context.configure().init()
+
+// i18n is automatically configured and available
+```
+
+### Multi-Service Configuration
+
+```typescript
+const multiServiceConfig = config('complex-app', {
+  services: {
+    'auth': {
+      alias: 'auth',
+      route: {
+        alias: 'auth',
+        path: '/api/auth',
+        service: 'auth-service'
+      }
+    },
+    'users': {
+      alias: 'users', 
+      route: {
+        alias: 'users',
+        path: '/api/users',
+        service: 'user-service'
+      }
+    },
+    'orders': {
+      alias: 'orders',
+      route: {
+        alias: 'orders',
+        path: '/api/orders',
+        service: 'order-service'  
+      }
+    }
+  }
+})
+
+const context = makeClientContext(multiServiceConfig)
+await context.configure().init()
+
+// Access different service routes
+const authRoute = context.serviceRoute('auth')
+const userRoute = context.serviceRoute('users')
+const orderRoute = context.serviceRoute('orders')
+
+// Use with API client
+const apiClient = context.service('api-client')
+await apiClient.call(authRoute, 'me')
+await apiClient.call(userRoute, 'profile')
+await apiClient.call(orderRoute, 'recent')
+```
+
+### Context with Resource Configuration
+
+```typescript
+import { config } from '@owlmeans/client-context'
+
+const resourceConfig = config('resource-app', {
+  services: {
+    'storage': {
+      alias: 'storage',
+      route: {
+        alias: 'storage',
+        path: '/api/storage',
+        service: 'storage-service'
+      }
+    }
+  },
+  // Additional resource configuration
+  resources: [{
+    alias: 'local-storage',
+    type: 'storage',
+    config: {
+      provider: 'localStorage'
+    }
+  }]
+})
+
+const context = makeClientContext(resourceConfig)
+await context.configure().init()
+
+// Access both service routes and resources
+const storageRoute = context.serviceRoute('storage')
+const localStorage = context.resource('local-storage')
+```
+
+### Service Route Error Handling
+
+```typescript
+try {
+  const route = context.serviceRoute('non-existent-service')
+} catch (error) {
+  if (error instanceof SyntaxError && error.message.includes('Service not found')) {
+    console.error('Service route not configured')
+    // Handle missing service configuration
+  }
+}
+
+// Safe service route access
+const hasUserService = 'user-service' in context.cfg.services
+if (hasUserService) {
+  const userRoute = context.serviceRoute('user-service')
+  // Use the route safely
+}
+```
+
+### Default Service Management
+
+```typescript
+// Set a service as default
+const primaryApi = context.serviceRoute('primary-api', true)
+
+// The service is now marked as default
+console.log(primaryApi.default) // true
+
+// Other services remain non-default unless explicitly set
+const secondaryApi = context.serviceRoute('secondary-api')
+console.log(secondaryApi.default) // false or undefined
+```
+
+## Configuration
+
+Client configuration supports various options for frontend applications:
+
+```typescript
+interface ClientConfig extends BasicClientConfig {
+  // Service route definitions
+  services: Record<string, CommonServiceRoute>
+  
+  // Internationalization settings
+  i18n?: {
+    defaultLng?: string
+    defaultNs?: string
+    resources?: Record<string, Record<string, any>>
+  }
+  
+  // Additional client-specific configuration
+  // (inherited from BasicClientConfig)
+}
+```
+
+### Service Route Configuration
+
+```typescript
+interface CommonServiceRoute {
+  alias: string                    // Service route alias
+  route: {
+    alias: string                  // Route alias
+    path: string                   // API endpoint path
+    service: string                // Backend service identifier
+    method?: string                // HTTP method
+    // Additional route configuration
+  }
+  default?: boolean                // Whether this is the default service
+}
+```
+
+## Error Handling
+
+The package provides descriptive error messages:
+
+- **Service not found**: Thrown when accessing non-configured service routes
+- **Configuration errors**: Thrown during context initialization with invalid config
+
+```typescript
+try {
+  const context = makeClientContext(invalidConfig)
+  await context.configure().init()
+} catch (error) {
+  console.error('Context initialization failed:', error)
+}
+```
+
+## Integration with OwlMeans Ecosystem
+
+This package integrates with:
+
+- **@owlmeans/context**: Base context management system
+- **@owlmeans/api**: API client for service communication  
+- **@owlmeans/client-config**: Client configuration management
+- **@owlmeans/route**: Service route definitions
+- **@owlmeans/i18n**: Internationalization support
+
+## Best Practices
+
+1. **Define all service routes** in configuration for proper API communication
+2. **Use meaningful service aliases** for easy identification
+3. **Configure i18n settings** for internationalized applications
+4. **Handle service route errors** gracefully with try-catch blocks
+5. **Set default services** appropriately for primary API endpoints
+
+## Related Packages
+
+- **@owlmeans/server-context**: Server-side context management
+- **@owlmeans/context**: Base context system
+- **@owlmeans/api**: API client integration
+- **@owlmeans/client-config**: Client configuration
+- **@owlmeans/route**: Route management
+
+## Utilities
+
+The package also provides utility functions in the `/utils` subpackage for advanced context management and configuration operations.
+
+```typescript
+import { /* utility functions */ } from '@owlmeans/client-context/utils'
+```
+
+## TypeScript Support
+
+The package is written in TypeScript and provides comprehensive type definitions for all client context operations, ensuring type safety for service routes, configuration, and API integration.

package/build/config.d.ts

@@ -0,0 +1,3 @@
+import type { ClientConfig } from './types.js';
+export declare const config: <C extends ClientConfig>(service: string, cfg?: Partial<C>) => C;
+//# sourceMappingURL=config.d.ts.map

package/build/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,eAAO,MAAM,MAAM,GAAI,CAAC,SAAS,YAAY,WAAW,MAAM,QAAQ,OAAO,CAAC,CAAC,CAAC,KAAG,CAIlF,CAAA"}

package/build/config.js

@@ -0,0 +1,6 @@
+import { AppType, makeBasicConfig } from '@owlmeans/context';
+export const config = (service, cfg) => {
+    const config = makeBasicConfig(AppType.Frontend, service, cfg);
+    return config;
+};
+//# sourceMappingURL=config.js.map

package/build/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAG5D,MAAM,CAAC,MAAM,MAAM,GAAG,CAAyB,OAAe,EAAE,GAAgB,EAAK,EAAE;IACrF,MAAM,MAAM,GAAM,eAAe,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,CAAA;IAEjE,OAAO,MAAM,CAAA;AACf,CAAC,CAAA"}

package/build/consts.d.ts

@@ -0,0 +1,2 @@
+export declare const PLUGINS = "plugins";
+//# 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,OAAO,YAAY,CAAA"}

package/build/consts.js

@@ -0,0 +1,2 @@
+export const PLUGINS = 'plugins';
+//# 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,OAAO,GAAG,SAAS,CAAA"}

package/build/context.d.ts

@@ -0,0 +1,3 @@
+import type { ClientConfig, ClientContext } from './types.js';
+export declare const makeClientContext: <C extends ClientConfig, T extends ClientContext<C>>(cfg: C) => T;
+//# sourceMappingURL=context.d.ts.map

package/build/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG7D,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,KAAG,CAqB9F,CAAA"}

package/build/context.js

@@ -0,0 +1,19 @@
+import { makeBasicContext } from '@owlmeans/context';
+import { appendApiClient } from '@owlmeans/api';
+export const makeClientContext = (cfg) => {
+    const context = makeBasicContext(cfg);
+    context.serviceRoute = (alias, makeDefault) => {
+        const service = context.cfg.services[alias];
+        if (service == null) {
+            throw new SyntaxError(`Service not found ${alias}`);
+        }
+        if (typeof makeDefault === 'boolean') {
+            service.default = makeDefault;
+        }
+        return service;
+    };
+    appendApiClient(context);
+    context.makeContext = makeClientContext;
+    return context;
+};
+//# sourceMappingURL=context.js.map

package/build/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEpD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAE/C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAqD,GAAM,EAAK,EAAE;IACjG,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAM,CAAA;IAE1C,OAAO,CAAC,YAAY,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE;QAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QAC3C,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YACpB,MAAM,IAAI,WAAW,CAAC,qBAAqB,KAAK,EAAE,CAAC,CAAA;QACrD,CAAC;QAED,IAAI,OAAO,WAAW,KAAK,SAAS,EAAE,CAAC;YACrC,OAAO,CAAC,OAAO,GAAG,WAAW,CAAA;QAC/B,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC,CAAA;IAED,eAAe,CAAO,OAAO,CAAC,CAAA;IAE9B,OAAO,CAAC,WAAW,GAAG,iBAA+C,CAAA;IAErE,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA"}

package/build/index.d.ts

@@ -0,0 +1,5 @@
+export type * from './types.js';
+export * from './context.js';
+export * from './config.js';
+export * from './consts.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":"AACA,mBAAmB,YAAY,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

package/build/index.js

@@ -0,0 +1,4 @@
+export * from './context.js';
+export * from './config.js';
+export * from './consts.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":"AAEA,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

package/build/types.d.ts

@@ -0,0 +1,13 @@
+import type { BasicClientConfig } from '@owlmeans/client-config';
+import type { BasicContext } from '@owlmeans/context';
+import type { CommonServiceRoute } from '@owlmeans/route';
+import type { I18nConfig } from '@owlmeans/i18n';
+import type { ConfigResourceAppend } from '@owlmeans/config';
+export interface ClientConfig extends BasicClientConfig {
+    services: Record<string, CommonServiceRoute>;
+    i18n?: I18nConfig;
+}
+export interface ClientContext<C extends ClientConfig = ClientConfig> extends BasicContext<C>, ConfigResourceAppend {
+    serviceRoute: (alias: string, makeDefault?: boolean) => CommonServiceRoute;
+}
+//# 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":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAE5D,MAAM,WAAW,YAAa,SAAQ,iBAAiB;IACrD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;IAC5C,IAAI,CAAC,EAAE,UAAU,CAAA;CAClB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,CAAE,SAAQ,YAAY,CAAC,CAAC,CAAC,EAC3F,oBAAoB;IACpB,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,KAAK,kBAAkB,CAAA;CAC3E"}

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,45 @@
+{
+  "name": "@owlmeans/client-context",
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "sleep 78 && 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"
+    },
+    "./utils": {
+      "import": "./build/utils/index.js",
+      "require": "./build/utils/index.js",
+      "default": "./build/utils/index.js",
+      "module": "./build/utils/index.js",
+      "types": "./build/utils/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@owlmeans/api": "0.1.0",
+    "@owlmeans/client-config": "0.1.0",
+    "@owlmeans/config": "0.1.0",
+    "@owlmeans/context": "0.1.0",
+    "@owlmeans/i18n": "0.1.0",
+    "@owlmeans/route": "0.1.0"
+  },
+  "devDependencies": {
+    "nodemon": "^3.1.7",
+    "typescript": "^5.6.3"
+  },
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/config.ts

@@ -0,0 +1,9 @@
+
+import { AppType, makeBasicConfig } from '@owlmeans/context'
+import type { ClientConfig } from './types.js'
+
+export const config = <C extends ClientConfig>(service: string, cfg?: Partial<C>): C => {
+  const config: C = makeBasicConfig(AppType.Frontend, service, cfg)
+
+  return config
+}

package/src/consts.ts

@@ -0,0 +1,2 @@
+
+export const PLUGINS = 'plugins'

package/src/context.ts

@@ -0,0 +1,26 @@
+import { makeBasicContext } from '@owlmeans/context'
+import type { ClientConfig, ClientContext } from './types.js'
+import { appendApiClient } from '@owlmeans/api'
+
+export const makeClientContext = <C extends ClientConfig, T extends ClientContext<C>>(cfg: C): T => {
+  const context = makeBasicContext(cfg) as T
+
+  context.serviceRoute = (alias, makeDefault) => {
+    const service = context.cfg.services[alias]
+    if (service == null) {
+      throw new SyntaxError(`Service not found ${alias}`)
+    }
+
+    if (typeof makeDefault === 'boolean') {
+      service.default = makeDefault
+    }
+
+    return service
+  }
+
+  appendApiClient<C, T>(context)
+
+  context.makeContext = makeClientContext as typeof context.makeContext
+
+  return context
+}

package/src/index.ts

@@ -0,0 +1,5 @@
+
+export type * from './types.js'
+export * from './context.js'
+export * from './config.js'
+export * from './consts.js'

package/src/types.ts

@@ -0,0 +1,15 @@
+import type { BasicClientConfig } from '@owlmeans/client-config'
+import type { BasicContext } from '@owlmeans/context'
+import type { CommonServiceRoute } from '@owlmeans/route'
+import type { I18nConfig } from '@owlmeans/i18n'
+import type { ConfigResourceAppend } from '@owlmeans/config'
+
+export interface ClientConfig extends BasicClientConfig {
+  services: Record<string, CommonServiceRoute>
+  i18n?: I18nConfig
+}
+
+export interface ClientContext<C extends ClientConfig = ClientConfig> extends BasicContext<C>,
+  ConfigResourceAppend {
+  serviceRoute: (alias: string, makeDefault?: boolean) => CommonServiceRoute
+}

package/tsconfig.json

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

package/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["./src/config.ts","./src/consts.ts","./src/context.ts","./src/index.ts","./src/types.ts"],"version":"5.6.3"}