@simplysm/service-server 13.0.100 → 14.0.4

package/README.md

@@ -1,131 +1,68 @@
 # @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
+Service server framework -- Fastify-based RPC server with WebSocket support, JWT authentication, service definitions, file upload/download, and built-in ORM/auto-update services.
+
+Depends on `@simplysm/service-common` for shared protocol and types.
+
+## API
+
+| Export | Kind | Category | Docs |
+|--------|------|----------|------|
+| `ServiceServerOptions` | interface | Types | [docs/types.md](docs/types.md) |
+| `AuthTokenPayload` | interface | Auth | [docs/auth.md](docs/auth.md) |
+| `signJwt` | function | Auth | [docs/auth.md](docs/auth.md) |
+| `verifyJwt` | function | Auth | [docs/auth.md](docs/auth.md) |
+| `decodeJwt` | function | Auth | [docs/auth.md](docs/auth.md) |
+| `ServiceContext` | interface | Core | [docs/core.md](docs/core.md) |
+| `createServiceContext` | function | Core | [docs/core.md](docs/core.md) |
+| `getServiceAuthPermissions` | function | Core | [docs/core.md](docs/core.md) |
+| `auth` | function | Core | [docs/core.md](docs/core.md) |
+| `ServiceDefinition` | interface | Core | [docs/core.md](docs/core.md) |
+| `defineService` | function | Core | [docs/core.md](docs/core.md) |
+| `ServiceMethods` | type | Core | [docs/core.md](docs/core.md) |
+| `executeServiceMethod` | function | Core | [docs/core.md](docs/core.md) |
+| `WebSocketHandler` | interface | Transport | [docs/transport.md](docs/transport.md) |
+| `createWebSocketHandler` | function | Transport | [docs/transport.md](docs/transport.md) |
+| `ServiceSocket` | interface | Transport | [docs/transport.md](docs/transport.md) |
+| `createServiceSocket` | function | Transport | [docs/transport.md](docs/transport.md) |
+| `handleHttpRequest` | function | Transport | [docs/transport.md](docs/transport.md) |
+| `handleUpload` | function | Transport | [docs/transport.md](docs/transport.md) |
+| `handleStaticFile` | function | Transport | [docs/transport.md](docs/transport.md) |
+| `ServerProtocolWrapper` | interface | Protocol | [docs/protocol.md](docs/protocol.md) |
+| `createServerProtocolWrapper` | function | Protocol | [docs/protocol.md](docs/protocol.md) |
+| `OrmService` | const | Services | [docs/services.md](docs/services.md) |
+| `OrmServiceType` | type | Services | [docs/services.md](docs/services.md) |
+| `AutoUpdateService` | const | Services | [docs/services.md](docs/services.md) |
+| `AutoUpdateServiceType` | type | Services | [docs/services.md](docs/services.md) |
+| `getConfig` | function | Utilities | [docs/utilities.md](docs/utilities.md) |
+| `handleV1Connection` | function | Legacy | [docs/legacy.md](docs/legacy.md) |
+| `ServiceServer` | class | Main | [docs/main.md](docs/main.md) |
+| `createServiceServer` | function | Main | [docs/main.md](docs/main.md) |
+
+## Usage
 
 ### Basic Server Setup
 
-```typescript
+```ts
 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 a service
+const GreetService = defineService("Greet", (ctx) => ({
+  hello(name: string) {
+    return `Hello, ${name}!`;
+  },
+  // Protected method requiring authentication
+  secret: auth(["admin"], (msg: string) => {
+    return `Secret for ${ctx.authInfo}: ${msg}`;
+  }),
 }));
 
-// Define an authenticated service
-const UserService = defineService("User", auth((ctx) => ({
-  getProfile: () => ctx.authInfo,
-  adminOnly: auth(["admin"], () => "admin-only data"),
-})));
-
-// Create and start server
+// Create and start the server
 const server = createServiceServer({
-  rootPath: "/app",
+  rootPath: process.cwd(),
   port: 3000,
   auth: { jwtSecret: "my-secret" },
-  services: [HealthService, UserService, OrmService, AutoUpdateService],
+  services: [GreetService],
 });
 
 await server.listen();
@@ -133,31 +70,40 @@ await server.listen();
 
 ### JWT Authentication
 
-```typescript
+```ts
 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" },
+// Sign a token
+const token = await signJwt("my-secret", {
+  roles: ["admin"],
+  data: { userId: 1 },
 });
 
-// Verify token
-const payload = await server.verifyAuthToken(token);
-console.log(payload.data.name); // "John"
+// Verify a token
+const payload = await verifyJwt("my-secret", token);
 ```
 
-### Server-Side Event Emission
+### Event Broadcasting
 
-```typescript
+```ts
 import { defineEvent } from "@simplysm/service-common";
 
-const OrderUpdated = defineEvent<{ orderId: number }, { status: string }>("OrderUpdated");
+const NotifyEvent = defineEvent<{ userId: number }, { text: string }>("Notify");
 
-// Emit to all listeners with matching orderId
-await server.emitEvent(
-  OrderUpdated,
-  (info) => info.orderId === 123,
-  { status: "shipped" },
-);
+// Emit from server
+await server.emitEvent(NotifyEvent, (info) => info.userId === 42, { text: "Hello!" });
+```
+
+### ORM Service
+
+The server includes a built-in `OrmService` for database operations. Include it in your service list:
+
+```ts
+import { createServiceServer, OrmService } from "@simplysm/service-server";
+
+const server = createServiceServer({
+  rootPath: process.cwd(),
+  port: 3000,
+  services: [OrmService],
+});
 ```

package/dist/auth/auth-token-payload.js

@@ -1 +1,2 @@
-//# sourceMappingURL=auth-token-payload.js.map
+export {};
+//# sourceMappingURL=auth-token-payload.js.map

package/dist/auth/auth-token-payload.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": [],
-  "mappings": "",
-  "names": []
-}
+{"version":3,"file":"auth-token-payload.js","sourceRoot":"","sources":["..\\..\\src\\auth\\auth-token-payload.ts"],"names":[],"mappings":""}

package/dist/auth/jwt-manager.js

@@ -1,26 +1,26 @@
 import * as jose from "jose";
-async function signJwt(jwtSecret, payload) {
-  const secret = new TextEncoder().encode(jwtSecret);
-  return new jose.SignJWT(payload).setProtectedHeader({ alg: "HS256" }).setIssuedAt().setExpirationTime("12h").sign(secret);
+export async function signJwt(jwtSecret, payload) {
+    const secret = new TextEncoder().encode(jwtSecret);
+    return new jose.SignJWT(payload)
+        .setProtectedHeader({ alg: "HS256" })
+        .setIssuedAt()
+        .setExpirationTime("12h")
+        .sign(secret);
 }
-async function verifyJwt(jwtSecret, token) {
-  const secret = new TextEncoder().encode(jwtSecret);
-  try {
-    const { payload } = await jose.jwtVerify(token, secret);
-    return payload;
-  } catch (err) {
-    if (err != null && typeof err === "object" && "code" in err && err.code === "ERR_JWT_EXPIRED") {
-      throw new Error("Token has expired.");
+export async function verifyJwt(jwtSecret, token) {
+    const secret = new TextEncoder().encode(jwtSecret);
+    try {
+        const { payload } = await jose.jwtVerify(token, secret);
+        return payload;
+    }
+    catch (err) {
+        if (err != null && typeof err === "object" && "code" in err && err.code === "ERR_JWT_EXPIRED") {
+            throw new Error("토큰이 만료되었습니다.");
+        }
+        throw new Error("유효하지 않은 토큰입니다.");
     }
-    throw new Error("Invalid token.");
-  }
 }
-function decodeJwt(token) {
-  return jose.decodeJwt(token);
+export function decodeJwt(token) {
+    return jose.decodeJwt(token);
 }
-export {
-  decodeJwt,
-  signJwt,
-  verifyJwt
-};
-//# sourceMappingURL=jwt-manager.js.map
+//# sourceMappingURL=jwt-manager.js.map

package/dist/auth/jwt-manager.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/auth/jwt-manager.ts"],
-  "mappings": "AAAA,YAAY,UAAU;AAGtB,eAAsB,QACpB,WACA,SACiB;AACjB,QAAM,SAAS,IAAI,YAAY,EAAE,OAAO,SAAS;AAEjD,SAAO,IAAI,KAAK,QAAQ,OAAO,EAC5B,mBAAmB,EAAE,KAAK,QAAQ,CAAC,EACnC,YAAY,EACZ,kBAAkB,KAAK,EACvB,KAAK,MAAM;AAChB;AAEA,eAAsB,UACpB,WACA,OACsC;AACtC,QAAM,SAAS,IAAI,YAAY,EAAE,OAAO,SAAS;AAEjD,MAAI;AACF,UAAM,EAAE,QAAQ,IAAI,MAAM,KAAK,UAAU,OAAO,MAAM;AACtD,WAAO;AAAA,EACT,SAAS,KAAK;AACZ,QAAI,OAAO,QAAQ,OAAO,QAAQ,YAAY,UAAU,OAAO,IAAI,SAAS,mBAAmB;AAC7F,YAAM,IAAI,MAAM,oBAAoB;AAAA,IACtC;AACA,UAAM,IAAI,MAAM,gBAAgB;AAAA,EAClC;AACF;AAEO,SAAS,UAA+B,OAA4C;AACzF,SAAO,KAAK,UAAU,KAAK;AAC7B;",
-  "names": []
-}
+{"version":3,"file":"jwt-manager.js","sourceRoot":"","sources":["..\\..\\src\\auth\\jwt-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAG7B,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,SAAiB,EACjB,OAAoC;IAEpC,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAEnD,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;SAC7B,kBAAkB,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;SACpC,WAAW,EAAE;SACb,iBAAiB,CAAC,KAAK,CAAC;SACxB,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,SAAiB,EACjB,KAAa;IAEb,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAEnD,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACxD,OAAO,OAAsC,CAAC;IAChD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;YAC9F,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;QAClC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAsB,KAAa;IAC1D,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAgC,CAAC;AAC9D,CAAC"}

package/dist/core/define-service.d.ts

@@ -8,7 +8,7 @@ export interface ServiceContext<TAuthInfo = unknown> {
         clientName: string;
         authTokenPayload?: AuthTokenPayload<TAuthInfo>;
     };
-    /** V1 legacy context (auto-update only) */
+    /** V1 레거시 컨텍스트 (자동 업데이트 전용) */
     legacy?: {
         clientName?: string;
     };
@@ -23,15 +23,15 @@ export declare function createServiceContext<TAuthInfo = unknown>(server: Servic
 }, legacy?: {
     clientName?: string;
 }): ServiceContext<TAuthInfo>;
-/** Read auth permissions from an auth()-wrapped function. Returns undefined if not wrapped. */
+/** auth()로 래핑된 함수에서 인증 권한을 읽는다. 래핑되지 않은 경우 undefined를 반환한다. */
 export declare function getServiceAuthPermissions(fn: Function): string[] | undefined;
 /**
- * Auth wrapper for service factories and methods.
+ * 서비스 팩토리 및 메서드용 인증 래퍼.
  *
- * - Service-level: `auth((ctx) => ({ ... }))` — all methods require login
- * - Service-level with roles: `auth(["admin"], (ctx) => ({ ... }))`
- * - Method-level: `auth(() => result)` — this method requires login
- * - Method-level with roles: `auth(["admin"], () => result)`
+ * - 서비스 수준: `auth((ctx) => ({ ... }))` — 모든 메서드에 로그인 필요
+ * - 서비스 수준 (역할 지정): `auth(["admin"], (ctx) => ({ ... }))`
+ * - 메서드 수준: `auth(() => result)` — 해당 메서드에 로그인 필요
+ * - 메서드 수준 (역할 지정): `auth(["admin"], () => result)`
  */
 export declare function auth<TFunction extends (...args: any[]) => any>(fn: TFunction): TFunction;
 export declare function auth<TFunction extends (...args: any[]) => any>(permissions: string[], fn: TFunction): TFunction;
@@ -41,15 +41,15 @@ export interface ServiceDefinition<TMethods = Record<string, (...args: any[]) =>
     authPermissions?: string[];
 }
 /**
- * Define a service with a name and factory function.
+ * 이름과 팩토리 함수로 서비스를 정의한다.
  *
  * @example
- * // Basic service
+ * // 기본 서비스
  * const HealthService = defineService("Health", (ctx) => ({
  *   check: () => ({ status: "ok" }),
  * }));
  *
- * // Service with auth
+ * // 인증이 필요한 서비스
  * const UserService = defineService("User", auth((ctx) => ({
  *   getProfile: () => ctx.authInfo,
  *   adminOnly: auth(["admin"], () => "admin"),
@@ -57,11 +57,11 @@ export interface ServiceDefinition<TMethods = Record<string, (...args: any[]) =>
  */
 export declare function defineService<TMethods extends Record<string, (...args: any[]) => any>>(name: string, factory: (ctx: ServiceContext) => TMethods): ServiceDefinition<TMethods>;
 /**
- * Extract method signatures from a ServiceDefinition for client-side type sharing.
+ * 클라이언트 측 타입 공유를 위해 ServiceDefinition에서 메서드 시그니처를 추출한다.
  *
  * @example
  * export type UserServiceType = ServiceMethods<typeof UserService>;
- * // Client: client.getService<UserServiceType>("User");
+ * // 클라이언트: client.getService<UserServiceType>("User");
  */
 export type ServiceMethods<TDefinition> = TDefinition extends ServiceDefinition<infer M> ? M : never;
 //# sourceMappingURL=define-service.d.ts.map

package/dist/core/define-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-service.d.ts","sourceRoot":"","sources":["..\\..\\src\\core\\define-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAOnE,MAAM,WAAW,cAAc,CAAC,SAAS,GAAG,OAAO;IACjD,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,IAAI,CAAC,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;KAChD,CAAC;IAEF,2CAA2C;IAC3C,MAAM,CAAC,EAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IAEF,IAAI,QAAQ,IAAI,SAAS,GAAG,SAAS,CAAC;IACtC,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAAC;IACrC,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAAC;IACrC,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC3C;AAED,wBAAgB,oBAAoB,CAAC,SAAS,GAAG,OAAO,EACtD,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,EAChC,MAAM,CAAC,EAAE,aAAa,EACtB,IAAI,CAAC,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAA;CAAE,EAC7E,MAAM,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,cAAc,CAAC,SAAS,CAAC,CAoD3B;AAMD,+FAA+F;AAC/F,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,EAAE,GAAG,SAAS,CAE5E;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,SAAS,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,SAAS,GAAG,SAAS,CAAC;AAC1F,wBAAgB,IAAI,CAAC,SAAS,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAC5D,WAAW,EAAE,MAAM,EAAE,EACrB,EAAE,EAAE,SAAS,GACZ,SAAS,CAAC;AAcb,MAAM,WAAW,iBAAiB,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;IACnF,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,QAAQ,CAAC;IAC3C,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,EACpF,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,QAAQ,GACzC,iBAAiB,CAAC,QAAQ,CAAC,CAM7B;AAID;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,CAAC,WAAW,IACpC,WAAW,SAAS,iBAAiB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC"}
+{"version":3,"file":"define-service.d.ts","sourceRoot":"","sources":["..\\..\\src\\core\\define-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAOnE,MAAM,WAAW,cAAc,CAAC,SAAS,GAAG,OAAO;IACjD,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,IAAI,CAAC,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;KAChD,CAAC;IAEF,+BAA+B;IAC/B,MAAM,CAAC,EAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IAEF,IAAI,QAAQ,IAAI,SAAS,GAAG,SAAS,CAAC;IACtC,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAAC;IACrC,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAAC;IACrC,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC3C;AAED,wBAAgB,oBAAoB,CAAC,SAAS,GAAG,OAAO,EACtD,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,EAChC,MAAM,CAAC,EAAE,aAAa,EACtB,IAAI,CAAC,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAA;CAAE,EAC7E,MAAM,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,cAAc,CAAC,SAAS,CAAC,CAoD3B;AAMD,+DAA+D;AAC/D,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,EAAE,GAAG,SAAS,CAE5E;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,SAAS,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,SAAS,GAAG,SAAS,CAAC;AAC1F,wBAAgB,IAAI,CAAC,SAAS,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAC5D,WAAW,EAAE,MAAM,EAAE,EACrB,EAAE,EAAE,SAAS,GACZ,SAAS,CAAC;AAcb,MAAM,WAAW,iBAAiB,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;IACnF,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,QAAQ,CAAC;IAC3C,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,EACpF,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,QAAQ,GACzC,iBAAiB,CAAC,QAAQ,CAAC,CAM7B;AAID;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,CAAC,WAAW,IACpC,WAAW,SAAS,iBAAiB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC"}

package/dist/core/define-service.js

@@ -1,70 +1,84 @@
 import { obj } from "@simplysm/core-common";
 import { getConfig } from "../utils/config-manager.js";
 import path from "path";
-function createServiceContext(server, socket, http, legacy) {
-  return {
-    server,
-    socket,
-    http,
-    legacy,
-    get authInfo() {
-      return socket?.authTokenPayload?.data ?? http?.authTokenPayload?.data;
-    },
-    get clientName() {
-      const name = socket?.clientName ?? http?.clientName ?? legacy?.clientName;
-      if (name == null) return void 0;
-      if (name === "" || name.includes("..") || name.includes("/") || name.includes("\\")) {
-        throw new Error(`Invalid client name: ${name}`);
-      }
-      return name;
-    },
-    get clientPath() {
-      const name = this.clientName;
-      return name == null ? void 0 : path.resolve(server.options.rootPath, "www", name);
-    },
-    async getConfig(section) {
-      let configParent = {};
-      const rootFilePath = path.resolve(server.options.rootPath, ".config.json");
-      const rootConfig = await getConfig(rootFilePath);
-      if (rootConfig != null) {
-        configParent = rootConfig;
-      }
-      const targetPath = this.clientPath;
-      if (targetPath != null) {
-        const clientFilePath = path.resolve(targetPath, ".config.json");
-        const clientConfig = await getConfig(clientFilePath);
-        if (clientConfig != null) {
-          configParent = obj.merge(configParent, clientConfig);
-        }
-      }
-      const config = configParent[section];
-      if (config == null) throw new Error(`Configuration section not found: ${section}`);
-      return config;
-    }
-  };
+export function createServiceContext(server, socket, http, legacy) {
+    return {
+        server,
+        socket,
+        http,
+        legacy,
+        get authInfo() {
+            return (socket?.authTokenPayload?.data ?? http?.authTokenPayload?.data);
+        },
+        get clientName() {
+            const name = socket?.clientName ?? http?.clientName ?? legacy?.clientName;
+            if (name == null)
+                return undefined;
+            if (name === "" || name.includes("..") || name.includes("/") || name.includes("\\")) {
+                throw new Error(`유효하지 않은 클라이언트 이름: ${name}`);
+            }
+            return name;
+        },
+        get clientPath() {
+            const name = this.clientName;
+            return name == null ? undefined : path.resolve(server.options.rootPath, "www", name);
+        },
+        async getConfig(section) {
+            let configParent = {};
+            const rootFilePath = path.resolve(server.options.rootPath, ".config.json");
+            const rootConfig = await getConfig(rootFilePath);
+            if (rootConfig != null) {
+                configParent = rootConfig;
+            }
+            const targetPath = this.clientPath;
+            if (targetPath != null) {
+                const clientFilePath = path.resolve(targetPath, ".config.json");
+                const clientConfig = await getConfig(clientFilePath);
+                if (clientConfig != null) {
+                    configParent = obj.merge(configParent, clientConfig);
+                }
+            }
+            const config = configParent[section];
+            if (config == null)
+                throw new Error(`설정 섹션을 찾을 수 없습니다: ${section}`);
+            return config;
+        },
+    };
 }
-const AUTH_PERMISSIONS = /* @__PURE__ */ Symbol("authPermissions");
-function getServiceAuthPermissions(fn) {
-  return fn[AUTH_PERMISSIONS];
+// ── 인증 ──
+const AUTH_PERMISSIONS = Symbol("authPermissions");
+/** auth()로 래핑된 함수에서 인증 권한을 읽는다. 래핑되지 않은 경우 undefined를 반환한다. */
+export function getServiceAuthPermissions(fn) {
+    return fn[AUTH_PERMISSIONS];
 }
-function auth(permissionsOrFn, maybeFn) {
-  const permissions = Array.isArray(permissionsOrFn) ? permissionsOrFn : [];
-  const fn = Array.isArray(permissionsOrFn) ? maybeFn : permissionsOrFn;
-  const wrapper = (...args) => fn(...args);
-  wrapper[AUTH_PERMISSIONS] = permissions;
-  return wrapper;
+export function auth(permissionsOrFn, maybeFn) {
+    const permissions = Array.isArray(permissionsOrFn) ? permissionsOrFn : [];
+    const fn = Array.isArray(permissionsOrFn) ? maybeFn : permissionsOrFn;
+    // 호출 동작을 유지하는 래퍼 생성
+    const wrapper = (...args) => fn(...args);
+    wrapper[AUTH_PERMISSIONS] = permissions;
+    return wrapper;
 }
-function defineService(name, factory) {
-  return {
-    name,
-    factory,
-    authPermissions: getServiceAuthPermissions(factory)
-  };
+/**
+ * 이름과 팩토리 함수로 서비스를 정의한다.
+ *
+ * @example
+ * // 기본 서비스
+ * const HealthService = defineService("Health", (ctx) => ({
+ *   check: () => ({ status: "ok" }),
+ * }));
+ *
+ * // 인증이 필요한 서비스
+ * const UserService = defineService("User", auth((ctx) => ({
+ *   getProfile: () => ctx.authInfo,
+ *   adminOnly: auth(["admin"], () => "admin"),
+ * })));
+ */
+export function defineService(name, factory) {
+    return {
+        name,
+        factory,
+        authPermissions: getServiceAuthPermissions(factory),
+    };
 }
-export {
-  auth,
-  createServiceContext,
-  defineService,
-  getServiceAuthPermissions
-};
-//# sourceMappingURL=define-service.js.map
+//# sourceMappingURL=define-service.js.map

package/dist/core/define-service.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/core/define-service.ts"],
-  "mappings": "AAGA,SAAS,WAAW;AACpB,SAAS,iBAAiB;AAC1B,OAAO,UAAU;AAuBV,SAAS,qBACd,QACA,QACA,MACA,QAC2B;AAC3B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IAEA,IAAI,WAAkC;AACpC,aAAQ,QAAQ,kBAAkB,QAAQ,MAAM,kBAAkB;AAAA,IAGpE;AAAA,IAEA,IAAI,aAAiC;AACnC,YAAM,OAAO,QAAQ,cAAc,MAAM,cAAc,QAAQ;AAC/D,UAAI,QAAQ,KAAM,QAAO;AAEzB,UAAI,SAAS,MAAM,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,GAAG,KAAK,KAAK,SAAS,IAAI,GAAG;AACnF,cAAM,IAAI,MAAM,wBAAwB,IAAI,EAAE;AAAA,MAChD;AAEA,aAAO;AAAA,IACT;AAAA,IAEA,IAAI,aAAiC;AACnC,YAAM,OAAO,KAAK;AAClB,aAAO,QAAQ,OAAO,SAAY,KAAK,QAAQ,OAAO,QAAQ,UAAU,OAAO,IAAI;AAAA,IACrF;AAAA,IAEA,MAAM,UAAa,SAA6B;AAC9C,UAAI,eAA8C,CAAC;AAEnD,YAAM,eAAe,KAAK,QAAQ,OAAO,QAAQ,UAAU,cAAc;AACzE,YAAM,aAAa,MAAM,UAA6B,YAAY;AAClE,UAAI,cAAc,MAAM;AACtB,uBAAe;AAAA,MACjB;AAEA,YAAM,aAAa,KAAK;AACxB,UAAI,cAAc,MAAM;AACtB,cAAM,iBAAiB,KAAK,QAAQ,YAAY,cAAc;AAC9D,cAAM,eAAe,MAAM,UAA6B,cAAc;AACtE,YAAI,gBAAgB,MAAM;AACxB,yBAAe,IAAI,MAAM,cAAc,YAAY;AAAA,QACrD;AAAA,MACF;AAEA,YAAM,SAAS,aAAa,OAAO;AACnC,UAAI,UAAU,KAAM,OAAM,IAAI,MAAM,oCAAoC,OAAO,EAAE;AACjF,aAAO;AAAA,IACT;AAAA,EACF;AACF;AAIA,MAAM,mBAAmB,uBAAO,iBAAiB;AAG1C,SAAS,0BAA0B,IAAoC;AAC5E,SAAQ,GAA0C,gBAAgB;AACpE;AAeO,SAAS,KAAK,iBAAsC,SAA8B;AACvF,QAAM,cAAc,MAAM,QAAQ,eAAe,IAAI,kBAAkB,CAAC;AACxE,QAAM,KAAK,MAAM,QAAQ,eAAe,IAAI,UAAW;AAGvD,QAAM,UAAU,IAAI,SAAoB,GAAG,GAAG,IAAI;AAClD,EAAC,QAA+C,gBAAgB,IAAI;AAEpE,SAAO;AACT;AAyBO,SAAS,cACd,MACA,SAC6B;AAC7B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,iBAAiB,0BAA0B,OAAO;AAAA,EACpD;AACF;",
-  "names": []
-}
+{"version":3,"file":"define-service.js","sourceRoot":"","sources":["..\\..\\src\\core\\define-service.ts"],"names":[],"mappings":"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"}

package/dist/core/service-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-executor.d.ts","sourceRoot":"","sources":["..\\..\\src\\core\\service-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,aAAa,EACrB,GAAG,EAAE;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,IAAI,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;KAAE,CAAC;CACpE,GACA,OAAO,CAAC,OAAO,CAAC,CAoDlB"}
+{"version":3,"file":"service-executor.d.ts","sourceRoot":"","sources":["..\\..\\src\\core\\service-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,aAAa,EACrB,GAAG,EAAE;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,IAAI,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;KAAE,CAAC;CACpE,GACA,OAAO,CAAC,OAAO,CAAC,CA0DlB"}