@owlmeans/server-app 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,638 @@
+# @owlmeans/server-app
+
+The **@owlmeans/server-app** package provides a comprehensive server application framework for OwlMeans Common Libraries, offering a complete foundation for building secure, scalable backend applications with authentication, API services, and module management.
+
+## Purpose
+
+This package serves as a high-level application framework that combines multiple OwlMeans packages into a cohesive server application foundation, specifically designed for:
+
+- **Complete Application Setup**: Quickly bootstrap full-featured server applications
+- **Integrated Authentication**: Built-in authentication and authorization capabilities
+- **API Server Management**: Automated API server configuration and lifecycle management
+- **Module System Integration**: Seamless integration with the OwlMeans module system
+- **Socket Support**: WebSocket functionality for real-time communication
+- **Static Resource Serving**: Static file serving capabilities
+- **Kubernetes Integration**: Optional Kubernetes deployment and management features
+- **Configuration Management**: Comprehensive configuration handling
+
+## Key Concepts
+
+### Application Framework
+This package acts as a meta-framework that combines and orchestrates multiple OwlMeans packages to create a complete server application environment.
+
+### Context-driven Architecture
+Uses the OwlMeans context system to manage dependencies, services, and application lifecycle in a structured manner.
+
+### Module-first Design
+Built around the OwlMeans module system where functionality is organized as URL units that can be transformed into API routes with handlers.
+
+### Integrated Services
+Automatically sets up and configures essential services like authentication, API handling, socket communication, and static resource serving.
+
+## Installation
+
+```bash
+npm install @owlmeans/server-app
+```
+
+## API Reference
+
+### Types
+
+#### `AppConfig`
+Application configuration interface extending ServerConfig.
+
+```typescript
+interface AppConfig extends ServerConfig, KlusterConfig {
+  services: Record<string, ServiceRoute>
+}
+```
+
+#### `AppContext<C extends AppConfig = AppConfig>`
+Application context interface with integrated service capabilities.
+
+```typescript
+interface AppContext<C extends AppConfig = AppConfig> extends ServerContext<C>,
+  AuthServiceAppend,
+  ApiServerAppend { }
+```
+
+### Core Functions
+
+#### `makeContext<C extends AppConfig, T extends AppContext<C>>(cfg: C, customize?: boolean): T`
+
+Creates a fully configured application context with all necessary services and middleware.
+
+**Parameters:**
+- `cfg`: Application configuration object
+- `customize`: Whether to skip default authentication setup (defaults to false)
+
+**Returns:** Configured application context
+
+```typescript
+import { makeContext } from '@owlmeans/server-app'
+
+const config = {
+  service: 'my-app',
+  layer: Layer.System,
+  type: AppType.Backend,
+  services: {
+    'database': { host: 'localhost', port: 5432 }
+  }
+}
+
+const context = makeContext(config)
+```
+
+#### `main<R, C extends AppConfig, T extends AppContext<C>>(ctx: T, modules: (CommonModule | ServerModule<R>)[]): Promise<void>`
+
+Main application entry point that registers modules, initializes the context, and starts the API server.
+
+**Parameters:**
+- `ctx`: Application context instance
+- `modules`: Array of modules to register with the application
+
+**Returns:** Promise that resolves when the application is running
+
+```typescript
+import { main, makeContext } from '@owlmeans/server-app'
+import { modules as defaultModules } from '@owlmeans/server-app'
+
+const context = makeContext(config)
+const allModules = [...defaultModules, ...customModules]
+
+await main(context, allModules)
+```
+
+### Pre-configured Modules
+
+#### `modules`
+Default set of modules that provide essential server functionality.
+
+```typescript
+const modules: CommonModule[]
+```
+
+Includes:
+- Server authentication modules
+- API configuration modules
+
+### Exported Utilities
+
+The package re-exports commonly used utilities from various OwlMeans packages:
+
+#### Configuration
+```typescript
+export { config } from '@owlmeans/server-context'
+export { sservice } from '@owlmeans/server-config'
+export { addWebService } from '@owlmeans/client-config'
+export { service, toConfigRecord, PLUGINS } from '@owlmeans/config'
+```
+
+#### Module System
+```typescript
+export { parent, filter, body, params, ModuleOutcome } from '@owlmeans/module'
+export { elevate, module, guard } from '@owlmeans/server-module'
+export { elevate as celevate } from '@owlmeans/client-module'
+export { route as broute } from '@owlmeans/server-route'
+export { route } from '@owlmeans/route'
+```
+
+#### API Handling
+```typescript
+export { handleRequest, handleBody, handleParams } from '@owlmeans/server-api'
+export type { AbstractRequest as Request, AbstractResponse as Response } from '@owlmeans/module'
+```
+
+#### Resource Management
+```typescript
+export { createListSchema, filterObject } from '@owlmeans/resource'
+export type { ListResult } from '@owlmeans/resource'
+```
+
+#### Context and Authentication
+```typescript
+export { AppType, BASE, Layer, assertContext } from '@owlmeans/context'
+export { DEFAULT_ALIAS as DAUTH_GUARD } from '@owlmeans/server-auth'
+export { GUARD_ED25519, BED255_CASHE_RESOURCE } from '@owlmeans/auth-common'
+```
+
+#### Kubernetes Integration
+```typescript
+export { klusterize } from '@owlmeans/kluster'
+```
+
+## Usage Examples
+
+### Basic Application Setup
+
+```typescript
+import { makeContext, main, modules, config, service } from '@owlmeans/server-app'
+import { AppType, Layer } from '@owlmeans/context'
+
+// Create application configuration
+const appConfig = config(
+  AppType.Backend,
+  'my-server-app',
+  service('database', {
+    host: process.env.DB_HOST || 'localhost',
+    port: parseInt(process.env.DB_PORT || '5432')
+  }),
+  {
+    layer: Layer.System,
+    port: 3000,
+    services: {
+      'auth-service': { host: 'localhost', port: 3001 },
+      'api-gateway': { host: 'localhost', port: 3002 }
+    }
+  }
+)
+
+// Create application context
+const context = makeContext(appConfig)
+
+// Start the application
+await main(context, modules)
+console.log('Server started on port 3000')
+```
+
+### Custom Module Integration
+
+```typescript
+import { 
+  makeContext, 
+  main, 
+  modules, 
+  module, 
+  route, 
+  guard, 
+  filter, 
+  body, 
+  handleRequest 
+} from '@owlmeans/server-app'
+
+// Create custom modules
+const userModule = module(
+  route('users', '/api/users', { method: 'GET' }),
+  guard('authenticated')
+)
+
+elevate(userModule, 'users', handleRequest(async (req, res) => {
+  const users = await getUsersFromDatabase()
+  res.resolve(users)
+}))
+
+const createUserModule = module(
+  route('create-user', '/api/users', { method: 'POST' }),
+  filter(body({
+    type: 'object',
+    properties: {
+      name: { type: 'string' },
+      email: { type: 'string' }
+    },
+    required: ['name', 'email']
+  }), guard('authenticated'))
+)
+
+elevate(createUserModule, 'create-user', handleRequest(async (req, res) => {
+  const userData = req.body
+  const user = await createUser(userData)
+  res.resolve(user, ModuleOutcome.Created)
+}))
+
+// Combine with default modules
+const allModules = [...modules, userModule, createUserModule]
+
+// Create and start application
+const context = makeContext(appConfig)
+await main(context, allModules)
+```
+
+### Database Integration
+
+```typescript
+import { makeContext, main, service, config } from '@owlmeans/server-app'
+
+// Configure database service
+const appConfig = config(
+  AppType.Backend,
+  'data-app',
+  service('mongodb', {
+    uri: process.env.MONGODB_URI || 'mongodb://localhost:27017',
+    database: 'myapp'
+  }),
+  service('redis', {
+    host: process.env.REDIS_HOST || 'localhost',
+    port: parseInt(process.env.REDIS_PORT || '6379')
+  })
+)
+
+const context = makeContext(appConfig)
+
+// Register database-related modules
+const databaseModules = [
+  // Your database modules here
+]
+
+await main(context, [...modules, ...databaseModules])
+```
+
+### Authentication and Authorization
+
+```typescript
+import { 
+  makeContext, 
+  main, 
+  modules, 
+  module, 
+  route, 
+  guard, 
+  DAUTH_GUARD,
+  GUARD_ED25519 
+} from '@owlmeans/server-app'
+
+// Create protected admin module
+const adminModule = module(
+  route('admin', '/api/admin', { method: 'GET' }),
+  guard([DAUTH_GUARD, GUARD_ED25519]) // Multiple guards
+)
+
+elevate(adminModule, 'admin', handleRequest(async (req, res) => {
+  // Only authenticated users with proper keys can access
+  const adminData = await getAdminData()
+  res.resolve(adminData)
+}))
+
+const context = makeContext(appConfig)
+await main(context, [...modules, adminModule])
+```
+
+### WebSocket Integration
+
+```typescript
+import { makeContext, main, modules } from '@owlmeans/server-app'
+
+// WebSocket is automatically configured in makeContext
+const context = makeContext(appConfig)
+
+// Access socket service if needed
+await context.configure().init()
+const socketService = context.service('socket')
+
+// Register socket event handlers
+socketService.on('user-connected', (socket, data) => {
+  console.log('User connected:', data.userId)
+})
+
+await main(context, modules)
+```
+
+### Static File Serving
+
+```typescript
+import { makeContext, main, modules } from '@owlmeans/server-app'
+
+const appConfig = config(
+  AppType.Backend,
+  'web-server',
+  {
+    staticPath: './public',
+    staticRoute: '/static'
+  }
+)
+
+// Static resource serving is automatically configured
+const context = makeContext(appConfig)
+await main(context, modules)
+
+// Now files in ./public are served at /static/*
+```
+
+### Custom Context Configuration
+
+```typescript
+import { makeContext, main, appendCustomService } from '@owlmeans/server-app'
+
+// Create context with custom flag to skip default auth
+const context = makeContext(appConfig, true) // customize = true
+
+// Add custom services
+const customService = createService('custom-service', {
+  process: async (data) => {
+    return processData(data)
+  }
+})
+
+context.registerService(customService)
+
+// Add custom authentication if needed
+// ... custom auth setup
+
+await main(context, modules)
+```
+
+### Environment-based Configuration
+
+```typescript
+import { 
+  makeContext, 
+  main, 
+  modules, 
+  config, 
+  service, 
+  toConfigRecord 
+} from '@owlmeans/server-app'
+
+// Create environment-aware configuration
+const appConfig = config(
+  AppType.Backend,
+  process.env.SERVICE_NAME || 'default-app',
+  ...toConfigRecord({
+    'database': {
+      host: process.env.DB_HOST || 'localhost',
+      port: parseInt(process.env.DB_PORT || '5432'),
+      ssl: process.env.NODE_ENV === 'production'
+    },
+    'redis': {
+      host: process.env.REDIS_HOST || 'localhost',
+      port: parseInt(process.env.REDIS_PORT || '6379')
+    }
+  }),
+  {
+    layer: process.env.NODE_ENV === 'production' ? Layer.Service : Layer.System,
+    port: parseInt(process.env.PORT || '3000'),
+    debug: {
+      all: process.env.NODE_ENV !== 'production'
+    }
+  }
+)
+
+const context = makeContext(appConfig)
+await main(context, modules)
+```
+
+### API Route Management
+
+```typescript
+import { 
+  module, 
+  route, 
+  broute,
+  filter, 
+  body, 
+  params, 
+  guard,
+  handleRequest,
+  handleBody,
+  handleParams
+} from '@owlmeans/server-app'
+
+// Create REST API modules
+const userRoutes = [
+  // GET /api/users
+  module(
+    broute('list-users', '/api/users'),
+    guard('authenticated')
+  ),
+  
+  // GET /api/users/:id
+  module(
+    broute('get-user', '/api/users/:id'),
+    filter(params({
+      type: 'object',
+      properties: {
+        id: { type: 'string', pattern: '^[0-9]+$' }
+      },
+      required: ['id']
+    }), guard('authenticated'))
+  ),
+  
+  // POST /api/users
+  module(
+    broute('create-user', '/api/users', { method: 'POST' }),
+    filter(body({
+      type: 'object',
+      properties: {
+        name: { type: 'string', minLength: 1 },
+        email: { type: 'string', format: 'email' }
+      },
+      required: ['name', 'email']
+    }), guard('authenticated'))
+  )
+]
+
+// Add handlers
+userRoutes.forEach(userModule => {
+  switch (userModule.getAlias()) {
+    case 'list-users':
+      elevate(userModule, 'list-users', handleRequest(async (req, res) => {
+        const users = await listUsers()
+        res.resolve(users)
+      }))
+      break
+    case 'get-user':
+      elevate(userModule, 'get-user', handleParams(async (req, res) => {
+        const user = await getUserById(req.params.id)
+        res.resolve(user)
+      }))
+      break
+    case 'create-user':
+      elevate(userModule, 'create-user', handleBody(async (req, res) => {
+        const user = await createUser(req.body)
+        res.resolve(user, ModuleOutcome.Created)
+      }))
+      break
+  }
+})
+```
+
+## Integration Patterns
+
+### Microservice Architecture
+
+```typescript
+import { makeContext, main, klusterize } from '@owlmeans/server-app'
+
+// Configure for Kubernetes deployment
+const appConfig = config(
+  AppType.Backend,
+  'user-service',
+  klusterize({
+    namespace: 'production',
+    serviceName: 'user-service',
+    replicas: 3
+  }),
+  {
+    port: 8080,
+    services: {
+      'auth-service': { 
+        host: 'auth-service.production.svc.cluster.local',
+        port: 8080 
+      }
+    }
+  }
+)
+
+const context = makeContext(appConfig)
+await main(context, [...modules, ...userServiceModules])
+```
+
+### API Gateway Pattern
+
+```typescript
+// API Gateway service
+const gatewayConfig = config(
+  AppType.Backend,
+  'api-gateway',
+  {
+    port: 80,
+    services: {
+      'user-service': { host: 'user-service', port: 8080 },
+      'order-service': { host: 'order-service', port: 8080 },
+      'payment-service': { host: 'payment-service', port: 8080 }
+    }
+  }
+)
+
+// Proxy modules that forward requests to appropriate services
+const proxyModules = [
+  createProxyModule('/api/users', 'user-service'),
+  createProxyModule('/api/orders', 'order-service'),
+  createProxyModule('/api/payments', 'payment-service')
+]
+```
+
+### Development vs Production
+
+```typescript
+import { makeContext, main, modules } from '@owlmeans/server-app'
+
+const isDevelopment = process.env.NODE_ENV === 'development'
+
+const appConfig = config(
+  AppType.Backend,
+  'app',
+  {
+    port: isDevelopment ? 3000 : 8080,
+    debug: { all: isDevelopment },
+    layer: isDevelopment ? Layer.System : Layer.Service,
+    services: isDevelopment ? {
+      'database': { host: 'localhost', port: 5432 }
+    } : {
+      'database': { 
+        host: 'postgres.production.svc.cluster.local', 
+        port: 5432 
+      }
+    }
+  }
+)
+
+const context = makeContext(appConfig)
+await main(context, modules)
+```
+
+## Error Handling
+
+```typescript
+import { main, makeContext } from '@owlmeans/server-app'
+
+try {
+  const context = makeContext(appConfig)
+  await main(context, modules)
+} catch (error) {
+  console.error('Application failed to start:', error)
+  
+  // Graceful shutdown
+  process.exit(1)
+}
+
+// Handle process signals
+process.on('SIGINT', async () => {
+  console.log('Received SIGINT, shutting down gracefully')
+  // Cleanup logic here
+  process.exit(0)
+})
+
+process.on('SIGTERM', async () => {
+  console.log('Received SIGTERM, shutting down gracefully')
+  // Cleanup logic here
+  process.exit(0)
+})
+```
+
+## Best Practices
+
+1. **Configuration Management**: Use environment variables for configuration
+2. **Module Organization**: Group related functionality into modules
+3. **Authentication**: Always implement proper authentication and authorization
+4. **Error Handling**: Implement comprehensive error handling and logging
+5. **Monitoring**: Add health check endpoints and monitoring capabilities
+6. **Security**: Follow security best practices for API development
+7. **Documentation**: Document your API endpoints and their contracts
+8. **Testing**: Write comprehensive tests for your modules and handlers
+
+## Dependencies
+
+This package depends on:
+- `@owlmeans/api` - API framework
+- `@owlmeans/client-config` - Client configuration utilities
+- `@owlmeans/config` - Configuration management
+- `@owlmeans/context` - Context management system
+- `@owlmeans/kluster` - Kubernetes integration
+- `@owlmeans/module` - Module system
+- `@owlmeans/route` - Routing functionality
+- `@owlmeans/server-api` - Server API framework
+- `@owlmeans/server-auth` - Server authentication
+- `@owlmeans/server-context` - Server context management
+- `@owlmeans/server-module` - Server module system
+- `@owlmeans/server-route` - Server routing
+- `@owlmeans/server-socket` - WebSocket support
+- `@owlmeans/static-resource` - Static file serving
+
+## Related Packages
+
+- [`@owlmeans/server-context`](../server-context) - Server context management
+- [`@owlmeans/server-api`](../server-api) - Server API framework
+- [`@owlmeans/server-auth`](../server-auth) - Server authentication
+- [`@owlmeans/server-module`](../server-module) - Server module system
+- [`@owlmeans/kluster`](../kluster) - Kubernetes integration

package/build/context.d.ts

@@ -0,0 +1,3 @@
+import type { AppConfig, AppContext } from './types.js';
+export declare const makeContext: <C extends AppConfig, T extends AppContext<C>>(cfg: C, customize?: boolean) => 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":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAMvD,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,SAAS,EAAE,CAAC,SAAS,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,cAAa,OAAO,MAkBnG,CAAA"}

package/build/context.js

@@ -0,0 +1,21 @@
+import { appendAuthService, AUTH_CACHE } from '@owlmeans/server-auth';
+import { makeServerContext } from '@owlmeans/server-context';
+import { appendApiServer } from '@owlmeans/server-api';
+import { appendApiClient } from '@owlmeans/api';
+import { appendStaticResource } from '@owlmeans/static-resource';
+import { appendSocketService, createSocketMiddleware } from '@owlmeans/server-socket';
+export const makeContext = (cfg, customize = false) => {
+    const context = makeServerContext(cfg);
+    appendApiServer(context);
+    appendApiClient(context);
+    appendSocketService(context);
+    context.registerMiddleware(createSocketMiddleware());
+    appendStaticResource(context);
+    if (!customize && !context.hasResource(AUTH_CACHE)) {
+        appendStaticResource(context, AUTH_CACHE);
+        appendAuthService(context);
+    }
+    context.makeContext = cfg => makeContext(cfg, customize);
+    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,iBAAiB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAE5D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAErF,MAAM,CAAC,MAAM,WAAW,GAAG,CAA+C,GAAM,EAAE,YAAqB,KAAK,EAAE,EAAE;IAC9G,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAM,CAAA;IAE3C,eAAe,CAAO,OAAO,CAAC,CAAA;IAC9B,eAAe,CAAO,OAAO,CAAC,CAAA;IAC9B,mBAAmB,CAAO,OAAO,CAAC,CAAA;IAElC,OAAO,CAAC,kBAAkB,CAAC,sBAAsB,EAAE,CAAC,CAAA;IAEpD,oBAAoB,CAAO,OAAO,CAAC,CAAA;IACnC,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;QACnD,oBAAoB,CAAO,OAAO,EAAE,UAAU,CAAC,CAAA;QAC/C,iBAAiB,CAAO,OAAO,CAAC,CAAA;IAClC,CAAC;IAED,OAAO,CAAC,WAAW,GAAG,GAAG,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,SAAS,CAAQ,CAAA;IAE/D,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA"}

package/build/exports.d.ts

@@ -0,0 +1,21 @@
+export { config } from '@owlmeans/server-context';
+export { sservice } from '@owlmeans/server-config';
+export { addWebService } from '@owlmeans/client-config';
+export { service, toConfigRecord, PLUGINS } from '@owlmeans/config';
+export { parent, filter, body, params, ModuleOutcome } from '@owlmeans/module';
+export type { AbstractRequest as Request, AbstractResponse as Response } from '@owlmeans/module';
+export { createListSchema, filterObject } from '@owlmeans/resource';
+export type { ListResult } from '@owlmeans/resource';
+export { AppType, BASE, Layer, assertContext } from '@owlmeans/context';
+export { elevate, module, guard } from '@owlmeans/server-module';
+export { elevate as celevate } from '@owlmeans/client-module';
+export type { ServerModule as Module, RefedModuleHandler } from '@owlmeans/server-module';
+export type { ClientModule } from '@owlmeans/client-module';
+export { route as broute } from '@owlmeans/server-route';
+export { handleRequest, handleBody, handleParams } from '@owlmeans/server-api';
+export { route } from '@owlmeans/route';
+export { DEFAULT_ALIAS as DAUTH_GUARD } from '@owlmeans/server-auth';
+export { klusterize } from '@owlmeans/kluster';
+export type { PluginConfig } from '@owlmeans/config';
+export { GUARD_ED25519, BED255_CASHE_RESOURCE } from '@owlmeans/auth-common';
+//# sourceMappingURL=exports.d.ts.map

package/build/exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../src/exports.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAC9E,YAAY,EAAE,eAAe,IAAI,OAAO,EAAE,gBAAgB,IAAI,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAChG,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACnE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACvE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAA;AAChE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAC7D,YAAY,EAAE,YAAY,IAAI,MAAM,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACzF,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,EAAE,KAAK,IAAI,MAAM,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAC9E,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,aAAa,IAAI,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA"}

package/build/exports.js

@@ -0,0 +1,16 @@
+export { config } from '@owlmeans/server-context';
+export { sservice } from '@owlmeans/server-config';
+export { addWebService } from '@owlmeans/client-config';
+export { service, toConfigRecord, PLUGINS } from '@owlmeans/config';
+export { parent, filter, body, params, ModuleOutcome } from '@owlmeans/module';
+export { createListSchema, filterObject } from '@owlmeans/resource';
+export { AppType, BASE, Layer, assertContext } from '@owlmeans/context';
+export { elevate, module, guard } from '@owlmeans/server-module';
+export { elevate as celevate } from '@owlmeans/client-module';
+export { route as broute } from '@owlmeans/server-route';
+export { handleRequest, handleBody, handleParams } from '@owlmeans/server-api';
+export { route } from '@owlmeans/route';
+export { DEFAULT_ALIAS as DAUTH_GUARD } from '@owlmeans/server-auth';
+export { klusterize } from '@owlmeans/kluster';
+export { GUARD_ED25519, BED255_CASHE_RESOURCE } from '@owlmeans/auth-common';
+//# sourceMappingURL=exports.js.map

package/build/exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.js","sourceRoot":"","sources":["../src/exports.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAE9E,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEnE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACvE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAA;AAChE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAG7D,OAAO,EAAE,KAAK,IAAI,MAAM,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAC9E,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,aAAa,IAAI,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA"}

package/build/index.d.ts

@@ -0,0 +1,6 @@
+export * from './exports.js';
+export * from './main.js';
+export type * from './types.js';
+export * from './context.js';
+export * from './modules.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;AAC5B,cAAc,WAAW,CAAA;AACzB,mBAAmB,YAAY,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}

package/build/index.js

@@ -0,0 +1,5 @@
+export * from './exports.js';
+export * from './main.js';
+export * from './context.js';
+export * from './modules.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,cAAc,WAAW,CAAA;AAEzB,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}

package/build/main.d.ts

@@ -0,0 +1,5 @@
+import type { ServerModule } from '@owlmeans/server-module';
+import type { CommonModule } from '@owlmeans/module';
+import type { AppContext, AppConfig } from './types.js';
+export declare const main: <R, C extends AppConfig, T extends AppContext<C>>(ctx: T, modules: (CommonModule | ServerModule<R>)[]) => Promise<void>;
+//# sourceMappingURL=main.d.ts.map

package/build/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAIvD,eAAO,MAAM,IAAI,GAAU,CAAC,EAAE,CAAC,SAAS,SAAS,EAAE,CAAC,SAAS,UAAU,CAAC,CAAC,CAAC,OACnE,CAAC,WAAW,CAAC,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,kBAKpD,CAAA"}

package/build/main.js

@@ -0,0 +1,8 @@
+// @TODO Remove or refactor request types. We actually don't use them and this make
+// a mess with <R
+export const main = async (ctx, modules) => {
+    ctx.registerModules(modules);
+    await ctx.configure().init();
+    await ctx.getApiServer().listen();
+};
+//# sourceMappingURL=main.js.map

package/build/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAMA,mFAAmF;AACnF,iBAAiB;AACjB,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,EACvB,GAAM,EAAE,OAA2C,EACnD,EAAE;IACF,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;IAC5B,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAA;IAC5B,MAAM,GAAG,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,CAAA;AACnC,CAAC,CAAA"}

package/build/modules.d.ts

@@ -0,0 +1,2 @@
+export declare const modules: import("@owlmeans/server-module").ServerModule<unknown>[];
+//# sourceMappingURL=modules.d.ts.map

package/build/modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules.d.ts","sourceRoot":"","sources":["../src/modules.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO,2DAA0B,CAAA"}

package/build/modules.js

@@ -0,0 +1,4 @@
+import { modules as apiConfig } from '@owlmeans/api-config-server';
+import { modules as list } from '@owlmeans/server-auth';
+export const modules = [...list, ...apiConfig];
+//# sourceMappingURL=modules.js.map

package/build/modules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules.js","sourceRoot":"","sources":["../src/modules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,uBAAuB,CAAA;AAEvD,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,SAAS,CAAC,CAAA"}

package/build/types.d.ts

@@ -0,0 +1,11 @@
+import type { ServerContext, ServerConfig } from '@owlmeans/server-context';
+import type { AuthServiceAppend } from '@owlmeans/server-auth';
+import type { KlusterConfig } from '@owlmeans/kluster';
+import type { ServiceRoute } from '@owlmeans/server-route';
+import type { ApiServerAppend } from '@owlmeans/server-api';
+export interface AppConfig extends ServerConfig, KlusterConfig {
+    services: Record<string, ServiceRoute>;
+}
+export interface AppContext<C extends AppConfig = AppConfig> extends ServerContext<C>, AuthServiceAppend, ApiServerAppend {
+}
+//# 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,aAAa,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE3D,MAAM,WAAW,SAAU,SAAQ,YAAY,EAAE,aAAa;IAC5D,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;CACvC;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC,EACnF,iBAAiB,EACjB,eAAe;CAAI"}

package/build/types.js

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

package/build/types.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@owlmeans/server-app",
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "sleep 270 && nodemon -e ts,tsx,json --watch src --exec \"tsc -p ./tsconfig.json\"",
+    "watch": "tsc -b -w --preserveWatchOutput --pretty"
+  },
+  "main": "build/index.js",
+  "module": "build/index.js",
+  "types": "build/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./build/index.js",
+      "require": "./build/index.js",
+      "default": "./build/index.js",
+      "module": "./build/index.js",
+      "types": "./build/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@owlmeans/api": "^0.1.0",
+    "@owlmeans/client-config": "^0.1.0",
+    "@owlmeans/client-module": "^0.1.0",
+    "@owlmeans/config": "^0.1.0",
+    "@owlmeans/context": "^0.1.0",
+    "@owlmeans/kluster": "^0.1.0",
+    "@owlmeans/module": "^0.1.0",
+    "@owlmeans/route": "^0.1.0",
+    "@owlmeans/server-api": "^0.1.0",
+    "@owlmeans/server-auth": "^0.1.0",
+    "@owlmeans/server-context": "^0.1.0",
+    "@owlmeans/server-module": "^0.1.0",
+    "@owlmeans/server-route": "^0.1.0",
+    "@owlmeans/server-socket": "^0.1.0",
+    "@owlmeans/static-resource": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.7.8",
+    "nodemon": "^3.1.7",
+    "typescript": "^5.6.3"
+  },
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/context.ts

@@ -0,0 +1,27 @@
+import { appendAuthService, AUTH_CACHE } from '@owlmeans/server-auth'
+import { makeServerContext } from '@owlmeans/server-context'
+import type { AppConfig, AppContext } from './types.js'
+import { appendApiServer } from '@owlmeans/server-api'
+import { appendApiClient } from '@owlmeans/api'
+import { appendStaticResource } from '@owlmeans/static-resource'
+import { appendSocketService, createSocketMiddleware } from '@owlmeans/server-socket'
+
+export const makeContext = <C extends AppConfig, T extends AppContext<C>>(cfg: C, customize: boolean = false) => {
+  const context = makeServerContext(cfg) as T
+
+  appendApiServer<C, T>(context)
+  appendApiClient<C, T>(context)
+  appendSocketService<C, T>(context)
+
+  context.registerMiddleware(createSocketMiddleware())
+
+  appendStaticResource<C, T>(context)
+  if (!customize && !context.hasResource(AUTH_CACHE)) {
+    appendStaticResource<C, T>(context, AUTH_CACHE)
+    appendAuthService<C, T>(context)
+  }
+
+  context.makeContext = cfg => makeContext(cfg, customize) as any
+
+  return context
+}

package/src/exports.ts

@@ -0,0 +1,21 @@
+
+export { config } from '@owlmeans/server-context'
+export { sservice } from '@owlmeans/server-config'
+export { addWebService } from '@owlmeans/client-config'
+export { service, toConfigRecord, PLUGINS } from '@owlmeans/config'
+export { parent, filter, body, params, ModuleOutcome } from '@owlmeans/module'
+export type { AbstractRequest as Request, AbstractResponse as Response } from '@owlmeans/module'
+export { createListSchema, filterObject } from '@owlmeans/resource'
+export type { ListResult } from '@owlmeans/resource'
+export { AppType, BASE, Layer, assertContext } from '@owlmeans/context'
+export { elevate, module, guard } from '@owlmeans/server-module'
+export { elevate as celevate } from '@owlmeans/client-module'
+export type { ServerModule as Module, RefedModuleHandler } from '@owlmeans/server-module'
+export type { ClientModule } from '@owlmeans/client-module'
+export { route as broute } from '@owlmeans/server-route'
+export { handleRequest, handleBody, handleParams } from '@owlmeans/server-api'
+export { route } from '@owlmeans/route'
+export { DEFAULT_ALIAS as DAUTH_GUARD } from '@owlmeans/server-auth'
+export { klusterize } from '@owlmeans/kluster'
+export type { PluginConfig } from '@owlmeans/config'
+export { GUARD_ED25519, BED255_CASHE_RESOURCE } from '@owlmeans/auth-common'

package/src/index.ts

@@ -0,0 +1,6 @@
+
+export * from './exports.js'
+export * from './main.js'
+export type * from './types.js'
+export * from './context.js'
+export * from './modules.js'

package/src/main.ts

@@ -0,0 +1,15 @@
+
+
+import type { ServerModule } from '@owlmeans/server-module'
+import type { CommonModule } from '@owlmeans/module'
+import type { AppContext, AppConfig } from './types.js'
+
+// @TODO Remove or refactor request types. We actually don't use them and this make
+// a mess with <R
+export const main = async <R, C extends AppConfig, T extends AppContext<C>>(
+  ctx: T, modules: (CommonModule | ServerModule<R>)[]
+) => {
+  ctx.registerModules(modules)
+  await ctx.configure().init()
+  await ctx.getApiServer().listen()
+}

package/src/modules.ts

@@ -0,0 +1,4 @@
+import { modules as apiConfig } from '@owlmeans/api-config-server'
+import { modules as list } from '@owlmeans/server-auth'
+
+export const modules = [...list, ...apiConfig]

package/src/types.ts

@@ -0,0 +1,13 @@
+import type { ServerContext, ServerConfig } from '@owlmeans/server-context'
+import type { AuthServiceAppend } from '@owlmeans/server-auth'
+import type { KlusterConfig } from '@owlmeans/kluster'
+import type { ServiceRoute } from '@owlmeans/server-route'
+import type { ApiServerAppend } from '@owlmeans/server-api'
+
+export interface AppConfig extends ServerConfig, KlusterConfig {
+  services: Record<string, ServiceRoute>
+}
+
+export interface AppContext<C extends AppConfig = AppConfig> extends ServerContext<C>,
+  AuthServiceAppend,
+  ApiServerAppend { }

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "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. */
+    "moduleResolution": "Bundler",
+  },
+  "exclude": [
+    "./dist/**/*",
+    "./build/**/*",
+    "./*.ts"
+  ]
+}

package/tsconfig.tsbuildinfo

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