@owlmeans/server-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,516 @@
+# @owlmeans/server-context
+
+Server-side context and dependency injection system for OwlMeans Common applications. This package extends the base OwlMeans context system with server-specific functionality, configuration management, and authentication capabilities for building secure backend services.
+
+## Overview
+
+The `@owlmeans/server-context` package provides server-specific extensions to the OwlMeans context system, offering:
+
+- **Server Context Management**: Enhanced context with server-specific capabilities
+- **Configuration Integration**: Built-in configuration resource management
+- **Authentication Guards**: Pre-configured Ed25519 authentication guards
+- **Middleware System**: Server-optimized middleware for request processing
+- **Service Registration**: Streamlined service registration for server components
+- **File Configuration**: File-based configuration reading capabilities
+- **Security Defaults**: Secure-by-default configuration for production servers
+
+## Installation
+
+```bash
+npm install @owlmeans/server-context
+```
+
+## Core Concepts
+
+### Server Context
+
+The `ServerContext` extends the basic OwlMeans context with server-specific functionality, including configuration resource management and enhanced service capabilities.
+
+### Server Configuration
+
+The `ServerConfig` combines server and client configuration options, providing a unified configuration structure for fullstack applications.
+
+### Security Integration
+
+Built-in integration with authentication guards and middleware for secure service-to-service communication.
+
+## API Reference
+
+### Types
+
+#### `ServerConfig`
+Extended configuration interface for server applications.
+
+```typescript
+interface ServerConfig extends BasicServerConfig, BasicClientConfig {
+  services: Record<string, ServiceRoute>
+}
+```
+
+#### `ServerContext<C extends ServerConfig>`
+Enhanced context interface with server capabilities.
+
+```typescript
+interface ServerContext<C extends ServerConfig> extends BasicContext<C>, ConfigResourceAppend {
+  // Inherits all BasicContext functionality plus configuration resource management
+}
+```
+
+### Factory Functions
+
+#### `makeServerContext<C, T>(cfg: C): T`
+Creates a server context with enhanced capabilities.
+
+**Parameters:**
+- `cfg`: Server configuration object
+
+**Returns:** Configured server context instance
+
+**Features:**
+- Registers file configuration reader middleware
+- Adds configuration resource management
+- Sets up trusted entity resource
+- Configures plugin resource management
+- Registers Ed25519 authentication guard
+- Adds authentication middleware
+
+#### `config<C>(service: string, cfg?: Partial<C>): C`
+Creates a server configuration with default settings.
+
+**Parameters:**
+- `service`: Service name identifier
+- `cfg`: Optional partial configuration
+
+**Returns:** Complete server configuration
+
+## Usage Examples
+
+### Basic Server Setup
+
+```typescript
+import { makeServerContext, config } from '@owlmeans/server-context'
+
+// Create server configuration
+const serverConfig = config('my-service', {
+  port: 3000,
+  host: 'localhost',
+  services: {
+    database: {
+      protocol: 'mongodb',
+      host: 'localhost',
+      port: 27017
+    }
+  }
+})
+
+// Create server context
+const context = makeServerContext(serverConfig)
+
+// Initialize the context
+await context.init()
+```
+
+### Configuration with Resources
+
+```typescript
+import { makeServerContext, config } from '@owlmeans/server-context'
+
+const serverConfig = config('api-server', {
+  // Database configurations
+  dbs: [
+    {
+      service: 'mongo',
+      alias: 'primary',
+      host: 'localhost',
+      port: 27017,
+      schema: 'myapp'
+    }
+  ],
+  
+  // Trusted services for authentication
+  trusted: [
+    {
+      id: 'internal-service',
+      recordType: 'trusted-source',
+      name: 'Internal Service',
+      entityId: 'internal',
+      scopes: ['api:*']
+    }
+  ],
+  
+  // Service routes
+  services: {
+    'user-service': {
+      protocol: 'https',
+      host: 'user-service.internal',
+      port: 443
+    },
+    'auth-service': {
+      protocol: 'https', 
+      host: 'auth-service.internal',
+      port: 443
+    }
+  }
+})
+
+const context = makeServerContext(serverConfig)
+```
+
+### Service Registration
+
+```typescript
+import { makeServerContext, config } from '@owlmeans/server-context'
+import { createDbService } from '@owlmeans/mongo'
+
+const context = makeServerContext(config('my-service'))
+
+// Register database service
+const dbService = createDbService('primary')
+context.registerService(dbService)
+
+// Register custom service
+const customService = {
+  alias: 'custom-logic',
+  initialized: false,
+  init: async () => {
+    console.log('Custom service initialized')
+    return true
+  }
+}
+context.registerService(customService)
+```
+
+### Authentication Setup
+
+```typescript
+import { makeServerContext, config } from '@owlmeans/server-context'
+
+const serverConfig = config('secure-service', {
+  trusted: [
+    {
+      id: 'client-app',
+      recordType: 'trusted-source',
+      name: 'Client Application',
+      credential: 'base64-encoded-public-key',
+      scopes: ['read', 'write']
+    }
+  ]
+})
+
+const context = makeServerContext(serverConfig)
+
+// The Ed25519 guard is automatically registered
+// Authentication middleware is automatically added
+// Requests with valid signatures will be authenticated
+```
+
+### Custom Middleware Registration
+
+```typescript
+import { makeServerContext, config } from '@owlmeans/server-context'
+import { MiddlewareType, MiddlewareStage } from '@owlmeans/context'
+
+const context = makeServerContext(config('my-service'))
+
+// Add custom middleware
+context.registerMiddleware({
+  type: MiddlewareType.Context,
+  stage: MiddlewareStage.Loading,
+  apply: async (ctx) => {
+    console.log('Custom middleware executed')
+    // Custom logic here
+  }
+})
+```
+
+### Configuration File Reading
+
+```typescript
+// config.json
+{
+  "service": "file-config-service",
+  "port": 8080,
+  "dbs": [
+    {
+      "service": "mongo",
+      "host": "mongodb://localhost:27017",
+      "schema": "production"
+    }
+  ]
+}
+```
+
+```typescript
+import { makeServerContext } from '@owlmeans/server-context'
+
+// File configuration is automatically read via middleware
+const context = makeServerContext({} as any)
+
+// Configuration will be populated from files
+await context.init()
+
+// Access configuration
+const config = context.cfg
+console.log(`Service running on port ${config.port}`)
+```
+
+### Resource Management
+
+```typescript
+import { makeServerContext, config } from '@owlmeans/server-context'
+
+const context = makeServerContext(config('resource-service'))
+
+// Access configuration resources
+const configResource = context.getConfigResource()
+const trustedResource = context.getConfigResource('trusted')
+const pluginResource = context.getConfigResource('plugin')
+
+// Create new configuration records
+await configResource.create({
+  id: 'feature-flag',
+  recordType: 'feature',
+  enabled: true,
+  description: 'Enable new feature'
+})
+
+// Query trusted entities
+const trustedEntities = await trustedResource.list({
+  criteria: { scopes: ['admin'] }
+})
+```
+
+### Plugin System Integration
+
+```typescript
+import { makeServerContext, config } from '@owlmeans/server-context'
+
+const serverConfig = config('plugin-host', {
+  plugins: [
+    {
+      id: 'auth-plugin',
+      recordType: 'plugin',
+      name: 'Authentication Plugin',
+      version: '1.0.0',
+      enabled: true,
+      config: {
+        provider: 'oauth2',
+        clientId: 'app-client-id'
+      }
+    }
+  ]
+})
+
+const context = makeServerContext(serverConfig)
+
+// Access plugin configuration
+const pluginResource = context.getConfigResource('plugin')
+const authPlugin = await pluginResource.get('auth-plugin')
+
+if (authPlugin.enabled) {
+  // Initialize plugin
+  console.log(`Loading ${authPlugin.name} v${authPlugin.version}`)
+}
+```
+
+### Multi-Service Architecture
+
+```typescript
+import { makeServerContext, config } from '@owlmeans/server-context'
+
+// Gateway service configuration
+const gatewayConfig = config('api-gateway', {
+  services: {
+    'user-service': {
+      protocol: 'http',
+      host: 'user-service',
+      port: 3001
+    },
+    'order-service': {
+      protocol: 'http', 
+      host: 'order-service',
+      port: 3002
+    },
+    'payment-service': {
+      protocol: 'https',
+      host: 'payment-service.external',
+      port: 443
+    }
+  },
+  
+  trusted: [
+    {
+      id: 'user-service',
+      recordType: 'trusted-source',
+      name: 'User Service',
+      scopes: ['users:*']
+    },
+    {
+      id: 'order-service', 
+      recordType: 'trusted-source',
+      name: 'Order Service',
+      scopes: ['orders:*', 'users:read']
+    }
+  ]
+})
+
+const gateway = makeServerContext(gatewayConfig)
+
+// Service can now route to other services with authentication
+```
+
+### Error Handling
+
+```typescript
+import { makeServerContext, config } from '@owlmeans/server-context'
+
+try {
+  const context = makeServerContext(config('error-service'))
+  await context.init()
+} catch (error) {
+  console.error('Failed to initialize server context:', error)
+  
+  // Handle specific initialization errors
+  if (error.message.includes('database')) {
+    console.error('Database connection failed')
+  } else if (error.message.includes('config')) {
+    console.error('Configuration error')
+  }
+  
+  process.exit(1)
+}
+```
+
+## Advanced Features
+
+### Custom Context Extensions
+
+```typescript
+import { makeServerContext, ServerContext, ServerConfig } from '@owlmeans/server-context'
+
+interface CustomConfig extends ServerConfig {
+  customFeature: boolean
+  apiKeys: string[]
+}
+
+interface CustomContext extends ServerContext<CustomConfig> {
+  customMethod: () => void
+}
+
+const createCustomContext = (cfg: CustomConfig): CustomContext => {
+  const context = makeServerContext(cfg) as CustomContext
+  
+  context.customMethod = () => {
+    console.log('Custom context method')
+  }
+  
+  return context
+}
+```
+
+### Dynamic Service Discovery
+
+```typescript
+import { makeServerContext, config } from '@owlmeans/server-context'
+
+const context = makeServerContext(config('discovery-service'))
+
+// Dynamic service registration
+const discoverServices = async () => {
+  const services = await fetchAvailableServices()
+  
+  services.forEach(service => {
+    context.cfg.services[service.name] = {
+      protocol: service.protocol,
+      host: service.host,
+      port: service.port
+    }
+  })
+}
+
+await discoverServices()
+```
+
+### Health Checks
+
+```typescript
+import { makeServerContext, config } from '@owlmeans/server-context'
+
+const context = makeServerContext(config('health-service'))
+
+const healthCheck = async () => {
+  try {
+    // Check all registered services
+    const services = Object.keys(context.cfg.services)
+    const healthStatuses = await Promise.all(
+      services.map(async service => {
+        try {
+          await context.service(service)
+          return { service, status: 'healthy' }
+        } catch (error) {
+          return { service, status: 'unhealthy', error: error.message }
+        }
+      })
+    )
+    
+    return healthStatuses
+  } catch (error) {
+    return { status: 'error', message: error.message }
+  }
+}
+```
+
+## Integration with OwlMeans Ecosystem
+
+The `@owlmeans/server-context` package integrates with:
+
+- **@owlmeans/context**: Base context and dependency injection system
+- **@owlmeans/config**: Configuration management and resource handling
+- **@owlmeans/server-config**: Server-specific configuration structures
+- **@owlmeans/client-config**: Client configuration for fullstack apps
+- **@owlmeans/server-route**: Service routing and discovery
+- **@owlmeans/auth-common**: Authentication middleware and guards
+- **@owlmeans/mongo**: Database service integration
+- **@owlmeans/redis**: Cache service integration
+
+## Security Features
+
+### Built-in Authentication
+- Ed25519 signature-based authentication guard
+- Automatic authentication middleware
+- Trusted entity management
+- Secure service-to-service communication
+
+### Configuration Security
+- Secure file configuration reading
+- Environment variable support
+- Secret management integration
+- Access control for configuration resources
+
+## Best Practices
+
+### Configuration Management
+- Use environment-specific configuration files
+- Store secrets in secure environment variables
+- Implement configuration validation
+- Use typed configuration interfaces
+
+### Service Architecture
+- Register services during context initialization
+- Implement proper service lifecycle management
+- Use dependency injection for service access
+- Handle service failures gracefully
+
+### Security
+- Always use authentication guards for protected services
+- Implement proper authorization checks
+- Validate all incoming requests
+- Use secure communication protocols
+
+### Performance
+- Initialize context once during application startup
+- Cache frequently accessed configuration
+- Use lazy service initialization where appropriate
+- Monitor resource usage and optimize accordingly
+
+Fixes #32.

package/build/config.d.ts

@@ -0,0 +1,3 @@
+import type { ServerConfig } from './types.js';
+export declare const config: <C extends ServerConfig>(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,CAKlF,CAAA"}

package/build/config.js

@@ -0,0 +1,7 @@
+import { AppType, makeBasicConfig } from '@owlmeans/context';
+export const config = (service, cfg) => {
+    const config = makeBasicConfig(AppType.Backend, service, cfg);
+    config.trusted = config.trusted ?? [];
+    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,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAA;IAChE,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAA;IAErC,OAAO,MAAM,CAAA;AACf,CAAC,CAAA"}

package/build/consts.d.ts

@@ -0,0 +1 @@
+//# 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":""}

package/build/consts.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=consts.js.map

package/build/consts.js.map

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

package/build/context.d.ts

@@ -0,0 +1,3 @@
+import { ServerConfig, ServerContext } from './types.js';
+export declare const makeServerContext: <C extends ServerConfig, T extends ServerContext<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,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAMxD,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,KAAG,CAc9F,CAAA"}

package/build/context.js

@@ -0,0 +1,17 @@
+import { appendConfigResource, PLUGIN_RECORD } from '@owlmeans/config';
+import { fileConfigReader } from './utils/context.js';
+import { makeBasicContext } from '@owlmeans/context';
+import { PLUGINS, TRUSTED } from '@owlmeans/config';
+import { authMiddleware, makeBasicEd25519Guard } from '@owlmeans/auth-common';
+export const makeServerContext = (cfg) => {
+    const context = makeBasicContext(cfg);
+    context.registerMiddleware(fileConfigReader);
+    context.makeContext = makeServerContext;
+    appendConfigResource(context);
+    appendConfigResource(context, TRUSTED, TRUSTED);
+    appendConfigResource(context, PLUGINS, PLUGIN_RECORD);
+    context.registerService(makeBasicEd25519Guard(TRUSTED));
+    context.registerMiddleware(authMiddleware);
+    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,oBAAoB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAEtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAE7E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAqD,GAAM,EAAK,EAAE;IACjG,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAM,CAAA;IAE1C,OAAO,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAA;IAE5C,OAAO,CAAC,WAAW,GAAG,iBAA+C,CAAA;IAErE,oBAAoB,CAAO,OAAO,CAAC,CAAA;IACnC,oBAAoB,CAAO,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IACrD,oBAAoB,CAAO,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,CAAA;IAC3D,OAAO,CAAC,eAAe,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAA;IACvD,OAAO,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAA;IAE1C,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA"}

package/build/index.d.ts

@@ -0,0 +1,4 @@
+export * from './context.js';
+export * from './config.js';
+export type * from './types.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,cAAc,cAAc,CAAA;AAE5B,cAAc,aAAa,CAAA;AAC3B,mBAAmB,YAAY,CAAA"}

package/build/index.js

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

package/build/types.d.ts

@@ -0,0 +1,11 @@
+import type { ServiceRoute } from '@owlmeans/server-route';
+import type { ConfigResourceAppend } from '@owlmeans/config';
+import type { BasicServerConfig } from '@owlmeans/server-config';
+import type { BasicClientConfig } from '@owlmeans/client-config';
+import type { BasicContext } from '@owlmeans/context';
+export interface ServerConfig extends BasicServerConfig, BasicClientConfig {
+    services: Record<string, ServiceRoute>;
+}
+export interface ServerContext<C extends ServerConfig> extends BasicContext<C>, ConfigResourceAppend {
+}
+//# 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,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,MAAM,WAAW,YAAa,SAAQ,iBAAiB,EAAE,iBAAiB;IACxE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;CACvC;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,YAAY,CAAE,SAAQ,YAAY,CAAC,CAAC,CAAC,EAAE,oBAAoB;CACnG"}

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/build/utils/context.d.ts

@@ -0,0 +1,3 @@
+import type { Middleware } from '@owlmeans/context';
+export declare const fileConfigReader: Middleware;
+//# sourceMappingURL=context.d.ts.map

package/build/utils/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/utils/context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAGnD,eAAO,MAAM,gBAAgB,EAAE,UAO9B,CAAA"}

package/build/utils/context.js

@@ -0,0 +1,26 @@
+import { MiddlewareStage, MiddlewareType } from '@owlmeans/context';
+import { readConfigValue } from '@owlmeans/server-config';
+export const fileConfigReader = {
+    type: MiddlewareType.Config,
+    stage: MiddlewareStage.Configuration,
+    apply: async (context) => {
+        const tree = context.cfg;
+        visitConfigLeafs(tree);
+    }
+};
+// @TODO Move to server config
+const visitConfigLeafs = (tree) => tree != null ? Object.entries(tree).forEach(([key, value]) => {
+    if (typeof value === 'string') {
+        const descriptor = Object.getOwnPropertyDescriptor(tree, key);
+        if (descriptor?.writable) {
+            tree[key] = readConfigValue(value);
+        }
+    }
+    else if (Array.isArray(value)) {
+        value.forEach(tree => { visitConfigLeafs(tree); });
+    }
+    else if (typeof value === 'object') {
+        visitConfigLeafs(value);
+    }
+}) : tree;
+//# sourceMappingURL=context.js.map

package/build/utils/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/utils/context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEnE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAEzD,MAAM,CAAC,MAAM,gBAAgB,GAAe;IAC1C,IAAI,EAAE,cAAc,CAAC,MAAM;IAC3B,KAAK,EAAE,eAAe,CAAC,aAAa;IACpC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,MAAM,IAAI,GAAS,OAAO,CAAC,GAAsB,CAAA;QACjD,gBAAgB,CAAC,IAAI,CAAC,CAAA;IACxB,CAAC;CACF,CAAA;AAED,8BAA8B;AAC9B,MAAM,gBAAgB,GAAG,CAAC,IAAU,EAAE,EAAE,CACtC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;IAC3D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;QAC7D,IAAI,UAAU,EAAE,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,CAAA;QACpC,CAAC;IACH,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,gBAAgB,CAAC,IAAY,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;IAC3D,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,gBAAgB,CAAC,KAAa,CAAC,CAAA;IACjC,CAAC;AACH,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA"}

package/build/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './context.js';
+//# sourceMappingURL=index.d.ts.map

package/build/utils/index.d.ts.map

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

package/build/utils/index.js

@@ -0,0 +1,2 @@
+export * from './context.js';
+//# sourceMappingURL=index.js.map

package/build/utils/index.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@owlmeans/server-context",
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "sleep 288 && 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/client-config": "^0.1.0",
+    "@owlmeans/config": "^0.1.0",
+    "@owlmeans/context": "^0.1.0",
+    "@owlmeans/route": "^0.1.0",
+    "@owlmeans/server-config": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.5.0",
+    "nodemon": "^3.1.7",
+    "typescript": "^5.6.3"
+  },
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/config.ts

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

package/src/consts.ts

@@ -0,0 +1 @@
+

package/src/context.ts

@@ -0,0 +1,22 @@
+import { appendConfigResource, PLUGIN_RECORD } from '@owlmeans/config'
+import { ServerConfig, ServerContext } from './types.js'
+import { fileConfigReader } from './utils/context.js'
+import { makeBasicContext } from '@owlmeans/context'
+import { PLUGINS, TRUSTED } from '@owlmeans/config'
+import { authMiddleware, makeBasicEd25519Guard } from '@owlmeans/auth-common'
+
+export const makeServerContext = <C extends ServerConfig, T extends ServerContext<C>>(cfg: C): T => {
+  const context = makeBasicContext(cfg) as T
+
+  context.registerMiddleware(fileConfigReader)
+
+  context.makeContext = makeServerContext as typeof context.makeContext
+
+  appendConfigResource<C, T>(context)
+  appendConfigResource<C, T>(context, TRUSTED, TRUSTED)
+  appendConfigResource<C, T>(context, PLUGINS, PLUGIN_RECORD)
+  context.registerService(makeBasicEd25519Guard(TRUSTED))
+  context.registerMiddleware(authMiddleware)
+
+  return context
+}

package/src/index.ts

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

package/src/types.ts

@@ -0,0 +1,12 @@
+import type { ServiceRoute } from '@owlmeans/server-route'
+import type { ConfigResourceAppend } from '@owlmeans/config'
+import type { BasicServerConfig } from '@owlmeans/server-config'
+import type { BasicClientConfig } from '@owlmeans/client-config'
+import type { BasicContext } from '@owlmeans/context'
+
+export interface ServerConfig extends BasicServerConfig, BasicClientConfig {
+  services: Record<string, ServiceRoute>
+}
+
+export interface ServerContext<C extends ServerConfig> extends BasicContext<C>, ConfigResourceAppend {
+}

package/src/utils/context.ts

@@ -0,0 +1,32 @@
+
+import { MiddlewareStage, MiddlewareType } from '@owlmeans/context'
+import type { Middleware } from '@owlmeans/context'
+import { readConfigValue } from '@owlmeans/server-config'
+
+export const fileConfigReader: Middleware = {
+  type: MiddlewareType.Config,
+  stage: MiddlewareStage.Configuration,
+  apply: async (context) => {
+    const tree: Tree = context.cfg as unknown as Tree
+    visitConfigLeafs(tree)
+  }
+}
+
+// @TODO Move to server config
+const visitConfigLeafs = (tree: Tree) =>
+  tree != null ? Object.entries(tree).forEach(([key, value]) => {
+    if (typeof value === 'string') {
+      const descriptor = Object.getOwnPropertyDescriptor(tree, key)
+      if (descriptor?.writable) {
+        tree[key] = readConfigValue(value)
+      }
+    } else if (Array.isArray(value)) {
+      value.forEach(tree => { visitConfigLeafs(tree as Tree) })
+    } else if (typeof value === 'object') {
+      visitConfigLeafs(value as Tree)
+    }
+  }) : tree
+
+type TreeKey = string | number | symbol
+type TreeValue = unknown | Array<unknown> | string
+interface Tree extends Record<TreeKey, TreeValue | Tree> { }

package/src/utils/index.ts

@@ -0,0 +1,2 @@
+
+export * from './context.js'

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "extends": [
+    "../tsconfig.default.json",
+  ],
+  "compilerOptions": {
+    "rootDir": "./src/", /* Specify the root folder within your source files. */
+    "outDir": "./build/", /* Specify an output folder for all emitted files. */
+  },
+  "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","./src/utils/context.ts","./src/utils/index.ts"],"version":"5.6.3"}