@simplysm/service-server 13.0.99 → 14.0.1

package/src/utils/config-manager.ts

@@ -5,12 +5,12 @@ import consola from "consola";
 
 const logger = consola.withTag("service-server:ConfigManager");
 
-// Value: Config object, Key: file path
+// 값: 설정 객체, 키: 파일 경로
 const _cache = new LazyGcMap<string, unknown>({
-  gcInterval: 10 * 60 * 1000, // Every 10 minutes
-  expireTime: 60 * 60 * 1000, // Expire after 1 hour
+  gcInterval: 10 * 60 * 1000, // 10분마다
+  expireTime: 60 * 60 * 1000, // 1시간 후 만료
   onExpire: async (filePath) => {
-    logger.debug(`Config cache expired and watcher released: ${path.basename(filePath)}`);
+    logger.debug(`설정 캐시 만료 및 워처 해제됨: ${path.basename(filePath)}`);
     await closeWatcher(filePath);
   },
 });
@@ -18,18 +18,18 @@ const _cache = new LazyGcMap<string, unknown>({
 const _watchers = new Map<string, FsWatcher>();
 
 export async function getConfig<TConfig>(filePath: string): Promise<TConfig | undefined> {
-  // 1. Cache hit (time auto-renewed)
+  // 1. 캐시 히트 (시간 자동 갱신)
   if (_cache.has(filePath)) {
     return _cache.get(filePath) as TConfig;
   }
 
   if (!(await fsx.exists(filePath))) return undefined;
 
-  // 2. Load and cache
+  // 2. 로드 및 캐시
   const config = await fsx.readJson(filePath);
   _cache.set(filePath, config);
 
-  // 3. Register watcher
+  // 3. 워처 등록
   if (!_watchers.has(filePath)) {
     try {
       const watcher = await FsWatcher.watch([filePath]);
@@ -39,20 +39,20 @@ export async function getConfig<TConfig>(filePath: string): Promise<TConfig | un
         if (!(await fsx.exists(filePath))) {
           _cache.delete(filePath);
           await closeWatcher(filePath);
-          logger.debug(`Config file deleted: ${path.basename(filePath)}`);
+          logger.debug(`설정 파일 삭제됨: ${path.basename(filePath)}`);
           return;
         }
 
         try {
           const newConfig = await fsx.readJson(filePath);
           _cache.set(filePath, newConfig);
-          logger.debug(`Config file live-reloaded: ${path.basename(filePath)}`);
+          logger.debug(`설정 파일 실시간 리로드됨: ${path.basename(filePath)}`);
         } catch (err) {
-          logger.warn(`Config file reload failed: ${filePath}`, err);
+          logger.warn(`설정 파일 리로드 실패: ${filePath}`, err);
         }
       });
     } catch (err) {
-      logger.error(`Watch failed: ${filePath}`, err);
+      logger.error(`워치 실패: ${filePath}`, err);
     }
   }
 

package/README.md

@@ -1,163 +0,0 @@
-# @simplysm/service-server
-
-Simplysm package - service module (server)
-
-Fastify-based service server with WebSocket support, JWT authentication, and built-in ORM/SMTP/auto-update services. Works with `@simplysm/service-client` for client-server communication.
-
-## Installation
-
-```bash
-npm install @simplysm/service-server
-```
-
-## API Overview
-
-### Types
-| API | Type | Description |
-|-----|------|-------------|
-| `ServiceServerOptions` | interface | Server config (rootPath, port, ssl, auth, services) |
-
--> See [docs/server.md](./docs/server.md) for details.
-
-### Auth
-| API | Type | Description |
-|-----|------|-------------|
-| `AuthTokenPayload` | interface | JWT payload with roles and custom data |
-| `signJwt` | function | Sign a JWT token (HS256, 12h expiry) |
-| `verifyJwt` | function | Verify and decode a JWT token |
-| `decodeJwt` | function | Decode JWT without verification |
-
--> See [docs/auth.md](./docs/auth.md) for details.
-
-### Core
-| API | Type | Description |
-|-----|------|-------------|
-| `ServiceContext` | interface | Context with server, socket, auth, config access |
-| `createServiceContext` | function | Create a service context |
-| `ServiceDefinition` | interface | Service definition (name, factory, auth) |
-| `defineService` | function | Define a service with name and factory |
-| `auth` | function | Auth wrapper for services/methods (login/roles) |
-| `getServiceAuthPermissions` | function | Read auth permissions from wrapped function |
-| `ServiceMethods` | type | Extract method types from ServiceDefinition |
-| `executeServiceMethod` | function | Execute service method with auth checks |
-
--> See [docs/core.md](./docs/core.md) for details.
-
-### Transport - Socket
-| API | Type | Description |
-|-----|------|-------------|
-| `WebSocketHandler` | interface | Multi-connection WebSocket manager |
-| `createWebSocketHandler` | function | Create WebSocket handler |
-| `ServiceSocket` | interface | Single WebSocket connection manager |
-| `createServiceSocket` | function | Create service socket |
-
--> See [docs/transport.md](./docs/transport.md) for details.
-
-### Transport - HTTP
-| API | Type | Description |
-|-----|------|-------------|
-| `handleHttpRequest` | function | Handle HTTP API requests |
-| `handleUpload` | function | Handle file upload (multipart) |
-| `handleStaticFile` | function | Serve static files from www/ |
-
--> See [docs/transport.md](./docs/transport.md) for details.
-
-### Protocol
-| API | Type | Description |
-|-----|------|-------------|
-| `ServerProtocolWrapper` | interface | Server protocol with worker thread offloading |
-| `createServerProtocolWrapper` | function | Create server protocol wrapper |
-
--> See [docs/transport.md](./docs/transport.md) for details.
-
-### Services
-| API | Type | Description |
-|-----|------|-------------|
-| `OrmService` | const | Built-in ORM service (DB connection, queries) |
-| `AutoUpdateService` | const | Built-in auto-update service |
-| `SmtpClientService` | const | Built-in SMTP email service |
-
--> See [docs/services.md](./docs/services.md) for details.
-
-### Utils
-| API | Type | Description |
-|-----|------|-------------|
-| `getConfig` | function | Read JSON config with caching and live-reload |
-
--> See [docs/server.md](./docs/server.md) for details.
-
-### Main
-| API | Type | Description |
-|-----|------|-------------|
-| `ServiceServer` | class | Main server (Fastify, WebSocket, auth, events) |
-| `createServiceServer` | function | Factory to create ServiceServer |
-
--> See [docs/server.md](./docs/server.md) for details.
-
-### Legacy
-| API | Type | Description |
-|-----|------|-------------|
-| `handleV1Connection` | function | V1 legacy client handler (auto-update only) |
-
--> See [docs/server.md](./docs/server.md) for details.
-
-## Usage Examples
-
-### Basic Server Setup
-
-```typescript
-import { createServiceServer, defineService, auth } from "@simplysm/service-server";
-import { OrmService, AutoUpdateService } from "@simplysm/service-server";
-
-// Define a custom service
-const HealthService = defineService("Health", (ctx) => ({
-  check: () => ({ status: "ok", time: new Date().toISOString() }),
-}));
-
-// Define an authenticated service
-const UserService = defineService("User", auth((ctx) => ({
-  getProfile: () => ctx.authInfo,
-  adminOnly: auth(["admin"], () => "admin-only data"),
-})));
-
-// Create and start server
-const server = createServiceServer({
-  rootPath: "/app",
-  port: 3000,
-  auth: { jwtSecret: "my-secret" },
-  services: [HealthService, UserService, OrmService, AutoUpdateService],
-});
-
-await server.listen();
-```
-
-### JWT Authentication
-
-```typescript
-import { signJwt, verifyJwt } from "@simplysm/service-server";
-
-// Sign token (in login handler)
-const token = await server.signAuthToken({
-  roles: ["user", "admin"],
-  data: { userId: 123, name: "John" },
-});
-
-// Verify token
-const payload = await server.verifyAuthToken(token);
-console.log(payload.data.name); // "John"
-```
-
-### Server-Side Event Emission
-
-```typescript
-import { defineEvent } from "@simplysm/service-common";
-
-const OrderUpdated = defineEvent<{ orderId: number }, { status: string }>("OrderUpdated");
-
-// Emit to all listeners with matching orderId
-await server.emitEvent(
-  OrderUpdated,
-  (info) => info.orderId === 123,
-  { status: "shipped" },
-);
-```

package/dist/services/smtp-client-service.d.ts

@@ -1,8 +0,0 @@
-import { type ServiceMethods } from "../core/define-service";
-import type { SmtpClientSendByDefaultOption, SmtpClientSendOption } from "@simplysm/service-common";
-export declare const SmtpClientService: import("..").ServiceDefinition<{
-    send(options: SmtpClientSendOption): Promise<string>;
-    sendByConfig(configName: string, options: SmtpClientSendByDefaultOption): Promise<string>;
-}>;
-export type SmtpClientServiceType = ServiceMethods<typeof SmtpClientService>;
-//# sourceMappingURL=smtp-client-service.d.ts.map

package/dist/services/smtp-client-service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"smtp-client-service.d.ts","sourceRoot":"","sources":["..\\..\\src\\services\\smtp-client-service.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,KAAK,EAEV,6BAA6B,EAC7B,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAElC,eAAO,MAAM,iBAAiB;kBACR,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;6BA6B3B,MAAM,WAAW,6BAA6B,GAAG,OAAO,CAAC,MAAM,CAAC;EAkB9F,CAAC;AAEJ,MAAM,MAAM,qBAAqB,GAAG,cAAc,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/services/smtp-client-service.js

@@ -1,46 +0,0 @@
-import nodemailer from "nodemailer";
-import { defineService } from "../core/define-service.js";
-const SmtpClientService = defineService("SmtpClient", (ctx) => ({
-  async send(options) {
-    return new Promise((resolve, reject) => {
-      const transport = nodemailer.createTransport({
-        host: options.host,
-        port: options.port,
-        secure: options.secure,
-        auth: options.user != null ? {
-          user: options.user,
-          pass: options.pass
-        } : void 0,
-        tls: {
-          rejectUnauthorized: false
-        }
-      });
-      transport.sendMail(options, (err, info) => {
-        if (err) {
-          reject(err);
-          return;
-        }
-        resolve(info.messageId);
-      });
-    });
-  },
-  async sendByConfig(configName, options) {
-    const config = (await ctx.getConfig("smtp"))[configName];
-    if (config == null) {
-      throw new Error(`SMTP config not found: ${configName}`);
-    }
-    return this.send({
-      user: config.user,
-      pass: config.pass,
-      host: config.host,
-      port: config.port,
-      secure: config.secure,
-      from: `"${config.senderName}" <${config.senderEmail ?? config.user}>`,
-      ...options
-    });
-  }
-}));
-export {
-  SmtpClientService
-};
-//# sourceMappingURL=smtp-client-service.js.map

package/dist/services/smtp-client-service.js.map

@@ -1,6 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/services/smtp-client-service.ts"],
-  "mappings": "AAAA,OAAO,gBAAgB;AACvB,SAAS,qBAA0C;AAO5C,MAAM,oBAAoB,cAAc,cAAc,CAAC,SAAS;AAAA,EACrE,MAAM,KAAK,SAAgD;AACzD,WAAO,IAAI,QAAgB,CAAC,SAAS,WAAW;AAC9C,YAAM,YAAY,WAAW,gBAAgB;AAAA,QAC3C,MAAM,QAAQ;AAAA,QACd,MAAM,QAAQ;AAAA,QACd,QAAQ,QAAQ;AAAA,QAChB,MACE,QAAQ,QAAQ,OACZ;AAAA,UACE,MAAM,QAAQ;AAAA,UACd,MAAM,QAAQ;AAAA,QAChB,IACA;AAAA,QACN,KAAK;AAAA,UACH,oBAAoB;AAAA,QACtB;AAAA,MACF,CAAC;AAED,gBAAU,SAAS,SAAuC,CAAC,KAAK,SAAS;AACvE,YAAI,KAAK;AACP,iBAAO,GAAG;AACV;AAAA,QACF;AAEA,gBAAQ,KAAK,SAAS;AAAA,MACxB,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,aAAa,YAAoB,SAAyD;AAC9F,UAAM,UACJ,MAAM,IAAI,UAAgE,MAAM,GAChF,UAAU;AACZ,QAAI,UAAU,MAAM;AAClB,YAAM,IAAI,MAAM,0BAA0B,UAAU,EAAE;AAAA,IACxD;AAEA,WAAO,KAAK,KAAK;AAAA,MACf,MAAM,OAAO;AAAA,MACb,MAAM,OAAO;AAAA,MACb,MAAM,OAAO;AAAA,MACb,MAAM,OAAO;AAAA,MACb,QAAQ,OAAO;AAAA,MACf,MAAM,IAAI,OAAO,UAAU,MAAM,OAAO,eAAe,OAAO,IAAI;AAAA,MAClE,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF,EAAE;",
-  "names": []
-}

package/docs/auth.md

@@ -1,59 +0,0 @@
-# Auth
-
-JWT-based authentication utilities using the `jose` library (HS256 algorithm).
-
-## `AuthTokenPayload`
-
-JWT token payload with roles and custom data. Extends `JWTPayload` from `jose`.
-
-```typescript
-interface AuthTokenPayload<TAuthInfo = unknown> extends JWTPayload {
-  roles: string[];
-  data: TAuthInfo;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `roles` | `string[]` | User roles for permission checking |
-| `data` | `TAuthInfo` | Custom auth data (user info, etc.) |
-
-## `signJwt`
-
-Sign a JWT token with HS256 algorithm. Token expires in 12 hours.
-
-```typescript
-async function signJwt<TAuthInfo = unknown>(
-  jwtSecret: string,
-  payload: AuthTokenPayload<TAuthInfo>,
-): Promise<string>;
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `jwtSecret` | `string` | Secret key for signing |
-| `payload` | `AuthTokenPayload<TAuthInfo>` | Token payload |
-
-## `verifyJwt`
-
-Verify and decode a JWT token. Throws on expired or invalid tokens.
-
-```typescript
-async function verifyJwt<TAuthInfo = unknown>(
-  jwtSecret: string,
-  token: string,
-): Promise<AuthTokenPayload<TAuthInfo>>;
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `jwtSecret` | `string` | Secret key for verification |
-| `token` | `string` | JWT token string |
-
-## `decodeJwt`
-
-Decode a JWT token without verification (for reading payload only).
-
-```typescript
-function decodeJwt<TAuthInfo = unknown>(token: string): AuthTokenPayload<TAuthInfo>;
-```

package/docs/core.md

@@ -1,133 +0,0 @@
-# Core
-
-## `ServiceContext`
-
-Context object passed to service factory functions. Provides access to server, socket, auth info, and configuration.
-
-```typescript
-interface ServiceContext<TAuthInfo = unknown> {
-  server: ServiceServer<TAuthInfo>;
-  socket?: ServiceSocket;
-  http?: {
-    clientName: string;
-    authTokenPayload?: AuthTokenPayload<TAuthInfo>;
-  };
-  legacy?: {
-    clientName?: string;
-  };
-
-  get authInfo(): TAuthInfo | undefined;
-  get clientName(): string | undefined;
-  get clientPath(): string | undefined;
-  getConfig<T>(section: string): Promise<T>;
-}
-```
-
-| Property | Type | Description |
-|----------|------|-------------|
-| `server` | `ServiceServer<TAuthInfo>` | Server instance |
-| `socket` | `ServiceSocket` | WebSocket connection (if via WebSocket) |
-| `http` | `object` | HTTP request info (if via HTTP) |
-| `legacy` | `object` | V1 legacy context (auto-update only) |
-| `authInfo` | `TAuthInfo \| undefined` | Authenticated user data |
-| `clientName` | `string \| undefined` | Client name |
-| `clientPath` | `string \| undefined` | Resolved client path on disk |
-| `getConfig()` | `<T>(section) => Promise<T>` | Read config from `.config.json` files |
-
-## `createServiceContext`
-
-Create a service context instance.
-
-```typescript
-function createServiceContext<TAuthInfo = unknown>(
-  server: ServiceServer<TAuthInfo>,
-  socket?: ServiceSocket,
-  http?: { clientName: string; authTokenPayload?: AuthTokenPayload<TAuthInfo> },
-  legacy?: { clientName?: string },
-): ServiceContext<TAuthInfo>;
-```
-
-## `ServiceDefinition`
-
-Service definition object. Contains name, factory function, and optional auth permissions.
-
-```typescript
-interface ServiceDefinition<TMethods = Record<string, (...args: any[]) => any>> {
-  name: string;
-  factory: (ctx: ServiceContext) => TMethods;
-  authPermissions?: string[];
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `name` | `string` | Service name |
-| `factory` | `(ctx: ServiceContext) => TMethods` | Factory function that creates method object |
-| `authPermissions` | `string[]` | Required permissions (from `auth()` wrapper) |
-
-## `defineService`
-
-Define a service with a name and factory function.
-
-```typescript
-function defineService<TMethods extends Record<string, (...args: any[]) => any>>(
-  name: string,
-  factory: (ctx: ServiceContext) => TMethods,
-): ServiceDefinition<TMethods>;
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `name` | `string` | Service name |
-| `factory` | `(ctx: ServiceContext) => TMethods` | Factory function |
-
-## `auth`
-
-Auth wrapper for service factories and methods. Can be applied at service-level or method-level with optional role requirements.
-
-```typescript
-function auth<TFunction extends (...args: any[]) => any>(fn: TFunction): TFunction;
-function auth<TFunction extends (...args: any[]) => any>(
-  permissions: string[],
-  fn: TFunction,
-): TFunction;
-```
-
-| Overload | Description |
-|----------|-------------|
-| `auth(fn)` | Require login (any authenticated user) |
-| `auth(["admin"], fn)` | Require specific roles |
-
-## `getServiceAuthPermissions`
-
-Read auth permissions from an `auth()`-wrapped function. Returns `undefined` if not wrapped.
-
-```typescript
-function getServiceAuthPermissions(fn: Function): string[] | undefined;
-```
-
-## `ServiceMethods`
-
-Extract method signatures from a `ServiceDefinition` for client-side type sharing.
-
-```typescript
-type ServiceMethods<TDefinition> =
-  TDefinition extends ServiceDefinition<infer M> ? M : never;
-```
-
-## `executeServiceMethod`
-
-Execute a service method with authentication and authorization checks.
-
-```typescript
-async function executeServiceMethod(
-  server: ServiceServer,
-  def: {
-    serviceName: string;
-    methodName: string;
-    params: unknown[];
-    socket?: ServiceSocket;
-    http?: { clientName: string; authTokenPayload?: AuthTokenPayload };
-  },
-): Promise<unknown>;
-```

package/docs/server.md

@@ -1,126 +0,0 @@
-# Server
-
-## `ServiceServerOptions`
-
-Configuration options for `ServiceServer`.
-
-```typescript
-interface ServiceServerOptions {
-  rootPath: string;
-  port: number;
-  ssl?: {
-    pfxBytes: Uint8Array;
-    passphrase: string;
-  };
-  auth?: {
-    jwtSecret: string;
-  };
-  services: ServiceDefinition[];
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `rootPath` | `string` | Root path for static files, uploads, and config |
-| `port` | `number` | Server port |
-| `ssl` | `object` | SSL/TLS config (PFX certificate) |
-| `ssl.pfxBytes` | `Uint8Array` | PFX certificate bytes |
-| `ssl.passphrase` | `string` | Certificate passphrase |
-| `auth` | `object` | Authentication config |
-| `auth.jwtSecret` | `string` | JWT signing secret |
-| `services` | `ServiceDefinition[]` | Service definitions to register |
-
-## `ServiceServer`
-
-Fastify-based service server with WebSocket support, JWT authentication, and built-in services. Extends `EventEmitter`.
-
-```typescript
-class ServiceServer<TAuthInfo = unknown> extends EventEmitter<{
-  ready: void;
-  close: void;
-}> {
-  isOpen: boolean;
-  readonly fastify: FastifyInstance;
-  readonly options: ServiceServerOptions;
-
-  constructor(options: ServiceServerOptions);
-
-  listen(): Promise<void>;
-  close(): Promise<void>;
-  broadcastReload(clientName: string | undefined, changedFileSet: Set<string>): Promise<void>;
-  emitEvent<TInfo, TData>(
-    eventDef: ServiceEventDef<TInfo, TData>,
-    infoSelector: (item: TInfo) => boolean,
-    data: TData,
-  ): Promise<void>;
-  signAuthToken(payload: AuthTokenPayload<TAuthInfo>): Promise<string>;
-  verifyAuthToken(token: string): Promise<AuthTokenPayload<TAuthInfo>>;
-}
-```
-
-| Property | Type | Description |
-|----------|------|-------------|
-| `isOpen` | `boolean` | Whether server is listening |
-| `fastify` | `FastifyInstance` | Underlying Fastify instance |
-| `options` | `ServiceServerOptions` | Server options |
-
-| Method | Description |
-|--------|-------------|
-| `listen()` | Start the server (registers plugins, routes, WebSocket, graceful shutdown) |
-| `close()` | Stop the server (close all connections) |
-| `broadcastReload()` | Broadcast reload to all connected clients |
-| `emitEvent()` | Emit event to matching clients |
-| `signAuthToken()` | Sign a JWT token |
-| `verifyAuthToken()` | Verify and decode a JWT token |
-
-### Registered Routes
-
-| Route | Method | Description |
-|-------|--------|-------------|
-| `/api/:service/:method` | GET/POST | HTTP service method endpoint |
-| `/upload` | POST | File upload endpoint (multipart) |
-| `/ws` | WebSocket | WebSocket service endpoint (Protocol V2) |
-| `/` | WebSocket | WebSocket endpoint (V1 legacy + V2) |
-| `/*` | GET | Static file serving from `www/` |
-
-### Registered Plugins
-
-- `@fastify/websocket` - WebSocket support
-- `@fastify/helmet` - Security headers (CSP, HSTS)
-- `@fastify/multipart` - File upload
-- `@fastify/static` - Static file serving
-- `@fastify/cors` - CORS support
-
-## `createServiceServer`
-
-Factory function to create a `ServiceServer` instance.
-
-```typescript
-function createServiceServer<TAuthInfo = unknown>(
-  options: ServiceServerOptions,
-): ServiceServer<TAuthInfo>;
-```
-
-## Utils
-
-### `getConfig`
-
-Read JSON configuration from file with caching and live-reload via file watcher. Cache expires after 1 hour.
-
-```typescript
-async function getConfig<TConfig>(filePath: string): Promise<TConfig | undefined>;
-```
-
-## Legacy
-
-### `handleV1Connection`
-
-V1 legacy client handler. Only auto-update is supported; all other requests return an upgrade-required error.
-
-```typescript
-function handleV1Connection(
-  socket: WebSocket,
-  autoUpdateMethods: { getLastVersion: (platform: string) => Promise<any> },
-  clientNameSetter?: (clientName: string | undefined) => void,
-): void;
-```

package/docs/services.md

@@ -1,58 +0,0 @@
-# Built-in Services
-
-Pre-defined service definitions ready to use with `ServiceServer`.
-
-## `OrmService`
-
-Server-side ORM service implementation. Requires authentication. Manages database connections per WebSocket socket (using `WeakMap`). Supports MySQL, MSSQL, and PostgreSQL via `@simplysm/orm-node`.
-
-```typescript
-const OrmService: ServiceDefinition;
-```
-
-Implements the `OrmService` interface from `@simplysm/service-common`:
-
-| Method | Description |
-|--------|-------------|
-| `getInfo()` | Get database dialect and connection info from config |
-| `connect()` | Open a new database connection, returns connection ID |
-| `close()` | Close a database connection |
-| `beginTransaction()` | Begin transaction |
-| `commitTransaction()` | Commit transaction |
-| `rollbackTransaction()` | Rollback transaction |
-| `executeParametrized()` | Execute parameterized SQL |
-| `executeDefs()` | Execute QueryDef array (builds SQL via QueryBuilder) |
-| `bulkInsert()` | Bulk insert records |
-
-**Note:** ORM service requires WebSocket connection (cannot be used over HTTP).
-
-## `AutoUpdateService`
-
-Server-side auto-update service implementation. Scans the client's platform-specific `updates/` directory for version files.
-
-```typescript
-const AutoUpdateService: ServiceDefinition;
-```
-
-Implements the `AutoUpdateService` interface from `@simplysm/service-common`:
-
-| Method | Description |
-|--------|-------------|
-| `getLastVersion(platform)` | Find latest version file for platform (win32, android, etc.) |
-
-Supported platforms and file extensions:
-- `android`: `.apk` files
-- Other platforms: `.exe` files
-
-## `SmtpClientService`
-
-Server-side SMTP email sending service. Uses `nodemailer` under the hood.
-
-```typescript
-const SmtpClientService: ServiceDefinition;
-```
-
-| Method | Description |
-|--------|-------------|
-| `send(options)` | Send email with full SMTP options |
-| `sendByDefault(options)` | Send email using server's default SMTP config |