@owlmeans/server-module 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,546 @@
+# @owlmeans/server-module
+
+Server-side module system for OwlMeans Common applications. This package provides the infrastructure for building and managing server modules that handle HTTP requests, implement business logic, and integrate with the OwlMeans routing and context systems.
+
+## Overview
+
+The `@owlmeans/server-module` package extends the base OwlMeans module system with server-specific functionality, providing:
+
+- **Server Module Creation**: Factory functions for creating server-side modules
+- **Route Integration**: Deep integration with server routing system
+- **Request Handling**: Standardized request/response processing
+- **Error Management**: Built-in error handling and fixer services
+- **Module Elevation**: Converting common modules to server modules
+- **Context Integration**: Seamless integration with server context
+- **Guard Support**: Authentication and authorization integration
+- **Reference Handling**: Module reference system for complex workflows
+
+## Installation
+
+```bash
+npm install @owlmeans/server-module
+```
+
+## Core Concepts
+
+### Server Module
+
+A `ServerModule` extends the common module interface with server-specific capabilities, including route models, request handlers, and error fixers.
+
+### Module Handler
+
+Functions that process incoming requests and generate responses, with access to the full OwlMeans context system.
+
+### Fixer Service
+
+Error handling services that can intercept and process errors before they're returned to clients.
+
+### Module Elevation
+
+The process of converting common modules to server modules with enhanced capabilities.
+
+## API Reference
+
+### Types
+
+#### `ServerModule<R>`
+Core server module interface with request handling capabilities.
+
+```typescript
+interface ServerModule<R> extends CommonModule {
+  route: ServerRouteModel<R>     // Server-specific route model
+  fixer?: string                 // Error fixer service alias
+  handle: ModuleHandler          // Request handler function
+}
+```
+
+#### `ModuleOptions<R>`
+Configuration options for module creation.
+
+```typescript
+interface ModuleOptions<R> extends CommonModuleOptions {
+  force?: boolean                    // Force elevation even if already elevated
+  fixer?: string                     // Error fixer service alias
+  intermediate?: boolean             // Mark as intermediate module
+  routeOptions?: ServerRouteOptions<R>  // Route-specific options
+}
+```
+
+#### `FixerService`
+Service interface for error handling.
+
+```typescript
+interface FixerService extends Service {
+  handle: <R>(reply: R, error: Error) => void
+}
+```
+
+#### `RefedModuleHandler<R>`
+Handler function that receives module reference.
+
+```typescript
+interface RefedModuleHandler<R = {}> {
+  (ref: ModuleRef<R>): ModuleHandler
+}
+```
+
+### Factory Functions
+
+#### `module<R>(arg, handler?, opts?): ServerModule<R>`
+Creates a server module from various input types.
+
+**Parameters:**
+- `arg`: CommonModule, ServerRouteModel, or CommonRouteModel
+- `handler`: Optional request handler function with module reference
+- `opts`: Optional module configuration
+
+**Returns:** Configured ServerModule instance
+
+**Examples:**
+
+```typescript
+// From route model
+const userModule = module(userRoute, (ref) => async (request, reply) => {
+  const users = await getUserList()
+  reply.resolve(users)
+})
+
+// From common module
+const elevatedModule = module(commonModule, handler, { 
+  fixer: 'error-handler',
+  force: true 
+})
+
+// With options
+const apiModule = module(apiRoute, handler, {
+  intermediate: true,
+  routeOptions: { cors: true }
+})
+```
+
+#### `elevate<R>(modules, alias, handler?, opts?): ServerModule<R>[]`
+Elevates common modules to server modules within a module collection.
+
+**Parameters:**
+- `modules`: Array of modules to search within
+- `alias`: Alias of module to elevate
+- `handler`: Optional new handler function
+- `opts`: Optional elevation options
+
+**Returns:** Updated modules array with elevated module
+
+**Example:**
+
+```typescript
+const modules = [commonModule1, commonModule2, commonModule3]
+
+// Elevate specific module
+const elevated = elevate(modules, 'user-api', (ref) => async (req, reply) => {
+  // New server-specific handler
+  const result = await processUserRequest(req)
+  reply.resolve(result)
+}, { fixer: 'user-error-handler' })
+```
+
+### Module Creation Patterns
+
+#### Basic Request Handler
+
+```typescript
+import { module } from '@owlmeans/server-module'
+
+const userModule = module(userRoute, (ref) => async (request, reply) => {
+  try {
+    const { params, query, body } = request
+    
+    // Business logic
+    const users = await userService.list(query)
+    
+    // Successful response
+    reply.resolve(users, ModuleOutcome.Ok)
+  } catch (error) {
+    // Error handling
+    reply.reject(error)
+  }
+})
+```
+
+#### Module with Context Access
+
+```typescript
+const contextAwareModule = module(route, (ref) => async (request, reply) => {
+  const context = ref.ref?.ctx
+  
+  // Access services from context
+  const dbService = context?.service('database')
+  const authService = context?.service('auth')
+  
+  // Process request with context
+  const user = authService.user()
+  const data = await dbService.get(request.params.id)
+  
+  reply.resolve(data)
+})
+```
+
+#### Module with Error Fixer
+
+```typescript
+const resilientModule = module(route, handler, {
+  fixer: 'error-fixer'
+})
+
+// Error fixer service
+const errorFixer: FixerService = {
+  alias: 'error-fixer',
+  initialized: true,
+  
+  handle: (reply, error) => {
+    if (error instanceof ValidationError) {
+      reply.reject(new BadRequestError(error.message))
+    } else if (error instanceof DatabaseError) {
+      reply.reject(new InternalServerError('Service temporarily unavailable'))
+    } else {
+      reply.reject(error)
+    }
+  }
+}
+```
+
+## Usage Examples
+
+### Basic CRUD Module
+
+```typescript
+import { module } from '@owlmeans/server-module'
+import { route } from '@owlmeans/server-route'
+
+// Define route
+const userRoute = route({
+  path: '/users/:id?',
+  method: RouteMethod.GET,
+  alias: 'user-crud'
+})
+
+// Create module
+const userModule = module(userRoute, (ref) => async (request, reply) => {
+  const { params, query } = request
+  
+  if (params.id) {
+    // Get single user
+    const user = await userService.get(params.id)
+    reply.resolve(user)
+  } else {
+    // List users
+    const users = await userService.list(query)
+    reply.resolve(users)
+  }
+})
+```
+
+### Authenticated Module
+
+```typescript
+const protectedModule = module(protectedRoute, (ref) => async (request, reply) => {
+  // Access authentication from context
+  const authService = ref.ref?.ctx?.service('auth')
+  const currentUser = authService?.user()
+  
+  if (!currentUser) {
+    reply.reject(new UnauthorizedError('Authentication required'))
+    return
+  }
+  
+  // Process authenticated request
+  const data = await processForUser(currentUser, request)
+  reply.resolve(data)
+}, {
+  guards: ['auth-guard']
+})
+```
+
+### File Upload Module
+
+```typescript
+const uploadModule = module(uploadRoute, (ref) => async (request, reply) => {
+  const { body, headers } = request
+  
+  // Handle file upload
+  if (headers['content-type']?.includes('multipart/form-data')) {
+    const files = await parseMultipartFiles(body)
+    const saved = await fileService.saveFiles(files)
+    
+    reply.resolve(saved, ModuleOutcome.Created)
+  } else {
+    reply.reject(new BadRequestError('Multipart data required'))
+  }
+})
+```
+
+### Module with Database Transaction
+
+```typescript
+const transactionalModule = module(route, (ref) => async (request, reply) => {
+  const dbService = ref.ref?.ctx?.service('database')
+  const transaction = await dbService.startTransaction()
+  
+  try {
+    const user = await userService.create(request.body, { transaction })
+    const profile = await profileService.create(user.id, { transaction })
+    
+    await transaction.commit()
+    reply.resolve({ user, profile }, ModuleOutcome.Created)
+  } catch (error) {
+    await transaction.rollback()
+    reply.reject(error)
+  }
+})
+```
+
+### Module Composition
+
+```typescript
+// Base module
+const baseModule = module(baseRoute, (ref) => async (request, reply) => {
+  // Base functionality
+  const result = await processBase(request)
+  reply.resolve(result)
+})
+
+// Elevated module with additional features
+const elevatedModules = elevate([baseModule], 'base-route', (ref) => async (request, reply) => {
+  // Enhanced functionality
+  const enhanced = await enhanceProcessing(request)
+  const result = await processBase(enhanced)
+  reply.resolve(result)
+}, {
+  fixer: 'enhanced-error-handler'
+})
+```
+
+### Module Factory Pattern
+
+```typescript
+const createCrudModule = <T>(
+  resource: string,
+  service: CrudService<T>
+) => {
+  const crudRoute = route({
+    path: `/${resource}/:id?`,
+    method: RouteMethod.GET,
+    alias: `${resource}-crud`
+  })
+  
+  return module(crudRoute, (ref) => async (request, reply) => {
+    const { params, query, body } = request
+    
+    switch (request.method) {
+      case 'GET':
+        if (params.id) {
+          const item = await service.get(params.id)
+          reply.resolve(item)
+        } else {
+          const items = await service.list(query)
+          reply.resolve(items)
+        }
+        break
+        
+      case 'POST':
+        const created = await service.create(body)
+        reply.resolve(created, ModuleOutcome.Created)
+        break
+        
+      case 'PUT':
+        const updated = await service.update(params.id, body)
+        reply.resolve(updated)
+        break
+        
+      case 'DELETE':
+        await service.delete(params.id)
+        reply.resolve(null, ModuleOutcome.Finished)
+        break
+        
+      default:
+        reply.reject(new MethodNotAllowedError())
+    }
+  })
+}
+
+// Usage
+const userModule = createCrudModule('users', userService)
+const productModule = createCrudModule('products', productService)
+```
+
+### Middleware Integration
+
+```typescript
+const middlewareModule = module(route, (ref) => async (request, reply) => {
+  // Pre-processing middleware
+  await validateRequest(request)
+  await logRequest(request)
+  
+  // Main processing
+  const result = await processRequest(request)
+  
+  // Post-processing middleware
+  await logResponse(result)
+  await cacheResponse(request, result)
+  
+  reply.resolve(result)
+})
+```
+
+### Error Handling Patterns
+
+```typescript
+// Global error fixer
+const globalFixer: FixerService = {
+  alias: 'global-error-fixer',
+  initialized: true,
+  
+  handle: (reply, error) => {
+    // Log error
+    console.error('Module error:', error)
+    
+    // Transform known errors
+    if (error.name === 'ValidationError') {
+      reply.reject(new BadRequestError(error.message))
+    } else if (error.name === 'NotFoundError') {
+      reply.reject(new NotFoundError(error.message))
+    } else {
+      // Generic error for unknown issues
+      reply.reject(new InternalServerError('An unexpected error occurred'))
+    }
+  }
+}
+
+// Module with error handling
+const robustModule = module(route, (ref) => async (request, reply) => {
+  try {
+    const result = await riskyOperation(request)
+    reply.resolve(result)
+  } catch (error) {
+    // Let fixer handle the error
+    throw error
+  }
+}, {
+  fixer: 'global-error-fixer'
+})
+```
+
+## Advanced Features
+
+### Module Chaining
+
+```typescript
+const chainModules = (modules: ServerModule<any>[]) => {
+  return modules.reduce((chain, module, index) => {
+    const nextModule = modules[index + 1]
+    
+    if (nextModule) {
+      // Chain modules together
+      const originalHandler = module.handle
+      module.handle = async (request, reply) => {
+        const result = await originalHandler(request, reply)
+        
+        // Pass result to next module
+        if (result) {
+          request.body = result
+          return nextModule.handle(request, reply)
+        }
+        
+        return result
+      }
+    }
+    
+    return module
+  })
+}
+```
+
+### Dynamic Module Loading
+
+```typescript
+const loadModuleFromConfig = async (config: ModuleConfig) => {
+  const route = await loadRoute(config.routeId)
+  const handler = await loadHandler(config.handlerId)
+  
+  return module(route, handler, {
+    fixer: config.errorHandler,
+    guards: config.guards
+  })
+}
+```
+
+### Module Testing
+
+```typescript
+import { createTestContext } from '@owlmeans/server-context'
+
+describe('User Module', () => {
+  let context: ServerContext
+  let userModule: ServerModule<any>
+  
+  beforeEach(() => {
+    context = createTestContext(testConfig)
+    userModule = module(userRoute, userHandler)
+    userModule.ctx = context
+  })
+  
+  it('should handle user creation', async () => {
+    const request = {
+      method: 'POST',
+      body: { name: 'John Doe', email: 'john@example.com' },
+      params: {},
+      query: {},
+      headers: {}
+    }
+    
+    const reply = createMockReply()
+    await userModule.handle(request, reply)
+    
+    expect(reply.resolved).toBe(true)
+    expect(reply.value).toHaveProperty('id')
+  })
+})
+```
+
+## Integration with OwlMeans Ecosystem
+
+The `@owlmeans/server-module` package integrates with:
+
+- **@owlmeans/module**: Base module system and interfaces
+- **@owlmeans/server-route**: Server routing and path handling
+- **@owlmeans/context**: Dependency injection and service access
+- **@owlmeans/server-context**: Server-specific context features
+- **@owlmeans/auth-common**: Authentication and authorization
+- **@owlmeans/resource**: Data persistence and management
+- **@owlmeans/error**: Error handling and transformation
+
+## Best Practices
+
+### Module Design
+- Keep modules focused on single responsibilities
+- Use descriptive aliases for easy identification
+- Implement proper error handling in all handlers
+- Validate input data before processing
+
+### Performance
+- Cache frequently accessed data
+- Use streaming for large response payloads
+- Implement proper pagination for list operations
+- Monitor module execution times
+
+### Security
+- Always validate and sanitize input data
+- Use appropriate authentication guards
+- Implement proper authorization checks
+- Log security-relevant events
+
+### Testing
+- Write unit tests for module handlers
+- Use test contexts for isolated testing
+- Mock external dependencies appropriately
+- Test error scenarios thoroughly
+
+Fixes #32.

package/build/helper.d.ts

@@ -0,0 +1,5 @@
+import type { ServerModule, ModuleOptions, RefedModuleHandler } from './types.js';
+import type { CommonModule } from '@owlmeans/module';
+export declare const elevate: <R>(modules: (CommonModule | ServerModule<R>)[], alias: string, handler?: RefedModuleHandler<R> | boolean | ModuleOptions<R>, opts?: boolean | ModuleOptions<R>) => ServerModule<R>[];
+export declare const guard: <R>(guard: string, opts?: ModuleOptions<R>) => ModuleOptions<R>;
+//# sourceMappingURL=helper.d.ts.map

package/build/helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAIjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEpD,eAAO,MAAM,OAAO,GAAI,CAAC,WACd,CAAC,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,SACpC,MAAM,YACH,kBAAkB,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,aAAa,CAAC,CAAC,CAAC,SACrD,OAAO,GAAG,aAAa,CAAC,CAAC,CAAC,KAChC,YAAY,CAAC,CAAC,CAAC,EAuBjB,CAAA;AAED,eAAO,MAAM,KAAK,GAAI,CAAC,SAAS,MAAM,SAAS,aAAa,CAAC,CAAC,CAAC,KAAG,aAAa,CAAC,CAAC,CACzC,CAAA"}

package/build/helper.js

@@ -0,0 +1,25 @@
+import { module } from './module.js';
+import { isServerRouteModel } from '@owlmeans/server-route';
+import { createBasicGuard } from './utils/helper.js';
+export const elevate = (modules, alias, handler, opts) => {
+    const idx = modules.findIndex(({ route }) => route.route.alias === alias);
+    if (idx === -1) {
+        throw new SyntaxError(`Module with alias ${alias} not present`);
+    }
+    if (typeof handler === 'boolean') {
+        opts = handler;
+        handler = undefined;
+    }
+    if (typeof handler === 'object' && typeof handler !== 'function') {
+        opts = handler;
+        handler = undefined;
+    }
+    const force = typeof opts === 'object' && opts.force;
+    if (isServerRouteModel(modules[idx].route) && !force) {
+        throw new SyntaxError(`Module with alias ${alias} is elready elevated`);
+    }
+    modules[idx] = module(modules[idx], handler, typeof opts === 'boolean' ? { intermediate: opts } : opts);
+    return modules;
+};
+export const guard = (guard, opts) => ({ ...createBasicGuard(guard, opts) });
+//# sourceMappingURL=helper.js.map

package/build/helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.js","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAGpD,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,OAA2C,EAC3C,KAAa,EACb,OAA4D,EAC5D,IAAiC,EACd,EAAE;IACrB,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,CAAA;IACzE,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,WAAW,CAAC,qBAAqB,KAAK,cAAc,CAAC,CAAA;IACjE,CAAC;IACD,IAAI,OAAO,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,GAAG,OAAO,CAAA;QACd,OAAO,GAAG,SAAS,CAAA;IACrB,CAAC;IACD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QACjE,IAAI,GAAG,OAAO,CAAA;QACd,OAAO,GAAG,SAAS,CAAA;IACrB,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAA;IACpD,IAAI,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACrD,MAAM,IAAI,WAAW,CAAC,qBAAqB,KAAK,sBAAsB,CAAC,CAAA;IACzE,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CACnB,OAAO,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CACjF,CAAA;IAED,OAAO,OAA4B,CAAA;AACrC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,KAAK,GAAG,CAAI,KAAa,EAAE,IAAuB,EAAoB,EAAE,CACnF,CAAC,EAAE,GAAG,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAA"}

package/build/index.d.ts

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

package/build/index.js

@@ -0,0 +1,3 @@
+export * from './module.js';
+export * from './helper.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,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

package/build/module.d.ts

@@ -0,0 +1,6 @@
+import type { ServerRouteModel } from '@owlmeans/server-route';
+import type { ServerModule, ModuleOptions, RefedModuleHandler } from './types.js';
+import type { CommonModule } from '@owlmeans/module';
+import type { CommonRouteModel } from '@owlmeans/route';
+export declare const module: <R>(arg: CommonModule | ServerRouteModel<R> | CommonRouteModel, handler?: RefedModuleHandler<R>, opts?: ModuleOptions<R>) => ServerModule<R>;
+//# sourceMappingURL=module.d.ts.map

package/build/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAa,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAG5F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAIvD,eAAO,MAAM,MAAM,GAAI,CAAC,OACjB,YAAY,GAAG,gBAAgB,CAAC,CAAC,CAAC,GAAG,gBAAgB,YAAY,kBAAkB,CAAC,CAAC,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,KACnH,YAAY,CAAC,CAAC,CA6ChB,CAAA"}

package/build/module.js

@@ -0,0 +1,44 @@
+import { isModule, makeCommonModule } from './utils/module.js';
+import { isServerRouteModel, route } from '@owlmeans/server-route';
+import { prependBase } from '@owlmeans/route/utils';
+export const module = (arg, handler, opts) => {
+    const moduleHandle = { ref: undefined };
+    let _module;
+    if (isModule(arg)) {
+        const routeModel = route(arg.route, opts?.intermediate ?? false, opts?.routeOptions);
+        _module = arg;
+        // _module = makeCommonModule(routeModel, {
+        //   ...opts,
+        //   guards: [...(arg.guards ?? []), ...(opts?.guards ?? [])],
+        //   gate: opts?.gate ?? arg.gate,
+        //   gateParams: opts?.gateParams ?? arg.gateParams,
+        // }) as ServerModule<R>
+        _module.route = routeModel;
+        _module.filter = opts?.filter ?? arg.filter;
+        _module.guards = [...(arg.guards ?? []), ...(opts?.guards ?? [])];
+        _module.gate = opts?.gate ?? arg.gate;
+        _module.gateParams = opts?.gateParams ?? arg.gateParams;
+    }
+    else if (isServerRouteModel(arg)) {
+        _module = makeCommonModule(arg, { ...opts });
+        _module.route = arg;
+    }
+    else {
+        const _route = route(arg, opts?.intermediate ?? false, opts?.routeOptions);
+        _module = makeCommonModule(_route, { ...opts });
+        _module.route = _route;
+    }
+    _module.fixer = opts?.fixer;
+    if (handler != null) {
+        _module.handle = handler(moduleHandle);
+    }
+    _module.reinitializeContext = (context) => {
+        const newModule = module(arg, handler, opts);
+        newModule.ctx = context;
+        return newModule;
+    };
+    _module.getPath = () => prependBase(_module.route.route);
+    moduleHandle.ref = _module;
+    return _module;
+};
+//# sourceMappingURL=module.js.map

package/build/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAC9D,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAIlE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEnD,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,GAA0D,EAAE,OAA+B,EAAE,IAAuB,EACnG,EAAE;IACnB,MAAM,YAAY,GAAiB,EAAE,GAAG,EAAE,SAAS,EAAE,CAAA;IAErD,IAAI,OAAwB,CAAA;IAE5B,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAClB,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,YAAY,IAAI,KAAK,EAAE,IAAI,EAAE,YAAY,CAAC,CAAA;QACpF,OAAO,GAAG,GAAsB,CAAA;QAChC,2CAA2C;QAC3C,aAAa;QACb,8DAA8D;QAC9D,kCAAkC;QAClC,oDAAoD;QACpD,wBAAwB;QACxB,OAAO,CAAC,KAAK,GAAG,UAAU,CAAA;QAC1B,OAAO,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,CAAA;QAC3C,OAAO,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,CAAA;QACjE,OAAO,CAAC,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,GAAG,CAAC,IAAI,CAAA;QACrC,OAAO,CAAC,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,GAAG,CAAC,UAAU,CAAA;IACzD,CAAC;SAAM,IAAI,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,OAAO,GAAG,gBAAgB,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,CAAoB,CAAA;QAC/D,OAAO,CAAC,KAAK,GAAG,GAAG,CAAA;IACrB,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,YAAY,IAAI,KAAK,EAAE,IAAI,EAAE,YAAY,CAAC,CAAA;QAC1E,OAAO,GAAG,gBAAgB,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,CAAoB,CAAA;QAClE,OAAO,CAAC,KAAK,GAAG,MAAM,CAAA;IACxB,CAAC;IAED,OAAO,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,CAAA;IAC3B,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACpB,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IACxC,CAAC;IAED,OAAO,CAAC,mBAAmB,GAAG,CAAI,OAA0B,EAAE,EAAE;QAC9D,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;QAC5C,SAAS,CAAC,GAAG,GAAG,OAAO,CAAA;QAEvB,OAAO,SAAc,CAAA;IACvB,CAAC,CAAA;IAED,OAAO,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAExD,YAAY,CAAC,GAAG,GAAG,OAAO,CAAA;IAE1B,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA"}

package/build/types.d.ts

@@ -0,0 +1,27 @@
+import type { ServerRouteModel, ServerRouteOptions } from '@owlmeans/server-route';
+import type { CommonModule, ModuleHandler, CommonModuleOptions } from '@owlmeans/module';
+import type { Service } from '@owlmeans/context';
+export interface ServerModule<R> extends CommonModule {
+    route: ServerRouteModel<R>;
+    fixer?: string;
+    handle: ModuleHandler;
+}
+export interface ModuleOptions<R> extends CommonModuleOptions {
+    /**
+     * Force module to be elevated even if it is already elevated
+     */
+    force?: boolean;
+    fixer?: string;
+    intermediate?: boolean;
+    routeOptions?: ServerRouteOptions<R>;
+}
+export interface FixerService extends Service {
+    handle: <R>(reply: R, error: Error) => void;
+}
+export interface ModuleRef<R> {
+    ref?: ServerModule<R>;
+}
+export interface RefedModuleHandler<R = {}> {
+    (ref: ModuleRef<R>): ModuleHandler;
+}
+//# 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,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACxF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAEhD,MAAM,WAAW,YAAY,CAAC,CAAC,CAAE,SAAQ,YAAY;IACnD,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,aAAa,CAAA;CACtB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,CAAE,SAAQ,mBAAmB;IAC3D;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,YAAY,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAA;CACrC;AAED,MAAM,WAAW,YAAa,SAAQ,OAAO;IAC3C,MAAM,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CAC5C;AAED,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,GAAG,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAA;CACtB;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,EAAE;IACxC,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,aAAa,CAAA;CACnC"}

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/helper.d.ts

@@ -0,0 +1,2 @@
+export { guard as createBasicGuard } from '@owlmeans/module';
+//# sourceMappingURL=helper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../src/utils/helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,IAAI,gBAAgB,EAAE,MAAM,kBAAkB,CAAA"}

package/build/utils/helper.js

@@ -0,0 +1,2 @@
+export { guard as createBasicGuard } from '@owlmeans/module';
+//# sourceMappingURL=helper.js.map

package/build/utils/helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.js","sourceRoot":"","sources":["../../src/utils/helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,IAAI,gBAAgB,EAAE,MAAM,kBAAkB,CAAA"}

package/build/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './module.js';
+export * from './helper.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,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

package/build/utils/index.js

@@ -0,0 +1,3 @@
+export * from './module.js';
+export * from './helper.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,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

package/build/utils/module.d.ts

@@ -0,0 +1,3 @@
+export { module as makeCommonModule } from '@owlmeans/module';
+export { isModule } from '@owlmeans/module/utils';
+//# sourceMappingURL=module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../src/utils/module.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,IAAI,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA"}

package/build/utils/module.js

@@ -0,0 +1,3 @@
+export { module as makeCommonModule } from '@owlmeans/module';
+export { isModule } from '@owlmeans/module/utils';
+//# sourceMappingURL=module.js.map

package/build/utils/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../src/utils/module.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,IAAI,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA"}

package/package.json

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

package/src/helper.ts

@@ -0,0 +1,38 @@
+import type { ServerModule, ModuleOptions, RefedModuleHandler } from './types.js'
+import { module } from './module.js'
+import { isServerRouteModel } from '@owlmeans/server-route'
+import { createBasicGuard } from './utils/helper.js'
+import type { CommonModule } from '@owlmeans/module'
+
+export const elevate = <R>(
+  modules: (CommonModule | ServerModule<R>)[],
+  alias: string,
+  handler?: RefedModuleHandler<R> | boolean | ModuleOptions<R>,
+  opts?: boolean | ModuleOptions<R>
+): ServerModule<R>[] => {
+  const idx = modules.findIndex(({ route }) => route.route.alias === alias)
+  if (idx === -1) {
+    throw new SyntaxError(`Module with alias ${alias} not present`)
+  }
+  if (typeof handler === 'boolean') {
+    opts = handler
+    handler = undefined
+  }
+  if (typeof handler === 'object' && typeof handler !== 'function') {
+    opts = handler
+    handler = undefined
+  }
+  const force = typeof opts === 'object' && opts.force
+  if (isServerRouteModel(modules[idx].route) && !force) {
+    throw new SyntaxError(`Module with alias ${alias} is elready elevated`)
+  }
+
+  modules[idx] = module(
+    modules[idx], handler, typeof opts === 'boolean' ? { intermediate: opts } : opts
+  )
+
+  return modules as ServerModule<R>[]
+}
+
+export const guard = <R>(guard: string, opts?: ModuleOptions<R>): ModuleOptions<R> =>
+  ({ ...createBasicGuard(guard, opts) })

package/src/index.ts

@@ -0,0 +1,4 @@
+
+export type * from './types.js'
+export * from './module.js'
+export * from './helper.js'

package/src/module.ts

@@ -0,0 +1,57 @@
+import type { ServerRouteModel } from '@owlmeans/server-route'
+import type { ServerModule, ModuleOptions, ModuleRef, RefedModuleHandler } from './types.js'
+import { isModule, makeCommonModule } from './utils/module.js'
+import { isServerRouteModel, route } from '@owlmeans/server-route'
+import type { CommonModule } from '@owlmeans/module'
+import type { CommonRouteModel } from '@owlmeans/route'
+import type { BasicContext } from '@owlmeans/context'
+import { prependBase } from '@owlmeans/route/utils'
+
+export const module = <R>(
+  arg: CommonModule | ServerRouteModel<R> | CommonRouteModel, handler?: RefedModuleHandler<R>, opts?: ModuleOptions<R>
+): ServerModule<R> => {
+  const moduleHandle: ModuleRef<R> = { ref: undefined }
+
+  let _module: ServerModule<R>
+
+  if (isModule(arg)) {
+    const routeModel = route(arg.route, opts?.intermediate ?? false, opts?.routeOptions)
+    _module = arg as ServerModule<R> 
+    // _module = makeCommonModule(routeModel, {
+    //   ...opts,
+    //   guards: [...(arg.guards ?? []), ...(opts?.guards ?? [])],
+    //   gate: opts?.gate ?? arg.gate,
+    //   gateParams: opts?.gateParams ?? arg.gateParams,
+    // }) as ServerModule<R>
+    _module.route = routeModel
+    _module.filter = opts?.filter ?? arg.filter
+    _module.guards = [...(arg.guards ?? []), ...(opts?.guards ?? [])]
+    _module.gate = opts?.gate ?? arg.gate
+    _module.gateParams = opts?.gateParams ?? arg.gateParams
+  } else if (isServerRouteModel(arg)) {
+    _module = makeCommonModule(arg, { ...opts }) as ServerModule<R>
+    _module.route = arg
+  } else {
+    const _route = route(arg, opts?.intermediate ?? false, opts?.routeOptions)
+    _module = makeCommonModule(_route, { ...opts }) as ServerModule<R>
+    _module.route = _route
+  }
+
+  _module.fixer = opts?.fixer
+  if (handler != null) {
+    _module.handle = handler(moduleHandle)
+  }
+
+  _module.reinitializeContext = <T>(context: BasicContext<any>) => {
+    const newModule = module(arg, handler, opts)
+    newModule.ctx = context
+
+    return newModule as T
+  }
+
+  _module.getPath = () => prependBase(_module.route.route)
+
+  moduleHandle.ref = _module
+
+  return _module
+}

package/src/types.ts

@@ -0,0 +1,31 @@
+import type { ServerRouteModel, ServerRouteOptions } from '@owlmeans/server-route'
+import type { CommonModule, ModuleHandler, CommonModuleOptions } from '@owlmeans/module'
+import type { Service } from '@owlmeans/context'
+
+export interface ServerModule<R> extends CommonModule {
+  route: ServerRouteModel<R>
+  fixer?: string
+  handle: ModuleHandler
+}
+
+export interface ModuleOptions<R> extends CommonModuleOptions {
+  /**
+   * Force module to be elevated even if it is already elevated
+   */
+  force?: boolean
+  fixer?: string
+  intermediate?: boolean
+  routeOptions?: ServerRouteOptions<R>
+}
+
+export interface FixerService extends Service {
+  handle: <R>(reply: R, error: Error) => void
+}
+
+export interface ModuleRef<R> { 
+  ref?: ServerModule<R>
+}
+
+export interface RefedModuleHandler<R = {}> {
+  (ref: ModuleRef<R>): ModuleHandler
+}

package/src/utils/helper.ts

@@ -0,0 +1,2 @@
+
+export { guard as createBasicGuard } from '@owlmeans/module'

package/src/utils/index.ts

@@ -0,0 +1,3 @@
+
+export * from './module.js'
+export * from './helper.js'

package/src/utils/module.ts

@@ -0,0 +1,3 @@
+
+export { module as makeCommonModule } from '@owlmeans/module'
+export { isModule } from '@owlmeans/module/utils'

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/helper.ts","./src/index.ts","./src/module.ts","./src/types.ts","./src/utils/helper.ts","./src/utils/index.ts","./src/utils/module.ts"],"version":"5.6.3"}