@simplysm/service-server 13.0.0-beta.45 → 13.0.0-beta.47

package/README.md

@@ -14,17 +14,18 @@ pnpm add @simplysm/service-server
 
 ## Main Modules
 
-### Core Classes
+### Core Functions and Classes
 
+- [`createServiceServer`](#basic-server-configuration) - Factory function for creating a ServiceServer instance
 - [`ServiceServer`](docs/server.md#serviceserver) - Main server class. Creates Fastify instance and configures routes/plugins
-- [`ServiceBase`](docs/server.md#custom-service-definition) - Service base abstract class. All custom services must inherit from this
+- [`defineService`](#custom-services) - Defines a service with a factory function pattern
 - `ServiceExecutor` - Internal executor that handles service method discovery, auth checks, and execution
 
 ### Authentication
 
-- [`Authorize`](docs/authentication.md#authorize-decorator) - Stage 3 decorator. Sets authentication permissions at class or method level
+- [`auth`](#authentication) - Function wrapper that sets authentication permissions at service or method level
+- [`getServiceAuthPermissions`](#authentication) - Queries auth permissions for a service or method (used internally by `ServiceExecutor`)
 - [`JwtManager`](docs/authentication.md#jwtmanager) - JWT token generation/verification/decoding based on jose library (HS256, 12-hour expiration)
-- [`getAuthPermissions`](docs/authentication.md#getauthpermissions) - Queries auth permissions for a service class/method (used internally by `ServiceExecutor`)
 - [`AuthTokenPayload`](docs/authentication.md#authtokenpayload) - JWT payload interface (includes `roles`, `data`)
 
 ### Transport Layer - WebSocket
@@ -62,9 +63,9 @@ pnpm add @simplysm/service-server
 ### Basic Server Configuration
 
 ```typescript
-import { ServiceServer } from "@simplysm/service-server";
+import { createServiceServer } from "@simplysm/service-server";
 
-const server = new ServiceServer({
+const server = createServiceServer({
   port: 8080,
   rootPath: "/app/data",
   services: [MyService],
@@ -92,43 +93,94 @@ See [`ServiceServerOptions`](docs/server.md#server-options-serviceserveroptions)
 
 ### Custom Services
 
-Services are defined by inheriting from `ServiceBase`. Service methods are called via RPC from the client.
+Services are defined using the `defineService` function. Service methods are called via RPC from the client.
 
 ```typescript
-import { ServiceBase } from "@simplysm/service-server";
+import { defineService } from "@simplysm/service-server";
 
-class MyService extends ServiceBase {
-  async hello(name: string): Promise<string> {
+export const MyService = defineService("MyService", (ctx) => ({
+  hello: async (name: string): Promise<string> => {
     return `Hello, ${name}!`;
-  }
+  },
 
-  async getServerTime(): Promise<Date> {
+  getServerTime: async (): Promise<Date> => {
     return new Date();
-  }
-}
+  },
+}));
+
+// Export type for client-side type sharing
+export type MyServiceMethods = import("@simplysm/service-server").ServiceMethods<typeof MyService>;
 ```
 
-See [Custom Service Definition](docs/server.md#custom-service-definition) for more details on `ServiceBase` properties and methods.
+#### ServiceContext
+
+The `ctx` parameter provides access to server resources:
+
+- `ctx.server` - ServiceServer instance
+- `ctx.socket` - ServiceSocket instance (WebSocket only, undefined for HTTP)
+- `ctx.http` - HTTP request/reply objects (HTTP only, undefined for WebSocket)
+- `ctx.authInfo` - Authentication info (set via JWT token)
+- `ctx.clientName` - Client identifier
+- `ctx.getConfig(name)` - Get server config by name
 
 ### Authentication
 
-Use the `@Authorize()` decorator to set authentication requirements:
+Use the `auth()` wrapper to set authentication requirements at service or method level:
 
 ```typescript
-import { ServiceBase, Authorize } from "@simplysm/service-server";
+import { defineService, auth } from "@simplysm/service-server";
 
-@Authorize()
-class UserService extends ServiceBase<{ userId: number; role: string }> {
-  async getProfile(): Promise<unknown> {
-    const userId = this.authInfo?.userId;
+interface UserAuthInfo {
+  userId: number;
+  role: string;
+}
+
+// Service-level auth: all methods require authentication
+export const UserService = defineService("UserService", auth((ctx) => ({
+  getProfile: async (): Promise<unknown> => {
+    const userId = (ctx.authInfo as UserAuthInfo)?.userId;
     // ...
-  }
+  },
 
-  @Authorize(["admin"])
-  async deleteUser(targetId: number): Promise<void> {
+  deleteUser: auth(["admin"], async (targetId: number): Promise<void> => {
     // Only users with admin role can call
-  }
-}
+  }),
+})));
+
+export type UserServiceMethods = import("@simplysm/service-server").ServiceMethods<typeof UserService>;
+```
+
+#### Auth Patterns
+
+**Method-level auth only:**
+```typescript
+export const MyService = defineService("MyService", (ctx) => ({
+  publicMethod: async (): Promise<void> => {
+    // No auth required
+  },
+
+  protectedMethod: auth(async (): Promise<void> => {
+    // Auth required
+  }),
+
+  adminMethod: auth(["admin"], async (): Promise<void> => {
+    // Auth + admin role required
+  }),
+}));
+```
+
+**Service-level auth with method override:**
+```typescript
+// All methods require authentication by default
+export const SecureService = defineService("SecureService", auth((ctx) => ({
+  normalMethod: async (): Promise<void> => {
+    // Auth required (inherited from service level)
+  },
+
+  adminMethod: auth(["admin"], async (): Promise<void> => {
+    // Auth + admin role required
+  }),
+})));
 ```
 
 See [Authentication](docs/authentication.md) for JWT token management and permission handling.
@@ -166,14 +218,12 @@ See [File Upload](docs/transport.md#file-upload) for more details.
 Publish real-time events to connected WebSocket clients:
 
 ```typescript
-import { ServiceEventListener } from "@simplysm/service-common";
+import { defineEvent } from "@simplysm/service-common";
 
-class OrderUpdatedEvent extends ServiceEventListener<
+export const OrderUpdatedEvent = defineEvent<
   { orderId: number },
   { status: string }
-> {
-  readonly eventName = "OrderUpdatedEvent";
-}
+>("OrderUpdatedEvent");
 
 await server.emitEvent(
   OrderUpdatedEvent,
@@ -196,7 +246,9 @@ The package provides several built-in services:
 Register them like any other service:
 
 ```typescript
-const server = new ServiceServer({
+import { createServiceServer, OrmService, CryptoService, SmtpService } from "@simplysm/service-server";
+
+const server = createServiceServer({
   port: 8080,
   rootPath: "/app/data",
   auth: { jwtSecret: "secret" },

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

@@ -1,7 +1,6 @@
 {
   "version": 3,
   "sources": [],
-  "sourcesContent": [],
   "mappings": "",
   "names": []
 }

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

@@ -1,7 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/auth/jwt-manager.ts"],
-  "sourcesContent": ["import type { ServiceServer } from \"../service-server\";\nimport * as jose from \"jose\";\nimport type { AuthTokenPayload } from \"./auth-token-payload\";\n\nexport class JwtManager<TAuthInfo = unknown> {\n  constructor(private readonly _server: ServiceServer<TAuthInfo>) {}\n\n  async sign(payload: AuthTokenPayload<TAuthInfo>): Promise<string> {\n    const jwtSecret = this._server.options.auth?.jwtSecret;\n    if (jwtSecret == null) throw new Error(\"JWT Secret\uC774 \uC815\uC758\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.\");\n\n    const secret = new TextEncoder().encode(jwtSecret);\n\n    return new jose.SignJWT(payload)\n      .setProtectedHeader({ alg: \"HS256\" })\n      .setIssuedAt()\n      .setExpirationTime(\"12h\")\n      .sign(secret);\n  }\n\n  async verify(token: string): Promise<AuthTokenPayload<TAuthInfo>> {\n    const jwtSecret = this._server.options.auth?.jwtSecret;\n    if (jwtSecret == null) throw new Error(\"JWT Secret\uC774 \uC815\uC758\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.\");\n\n    const secret = new TextEncoder().encode(jwtSecret);\n\n    try {\n      const { payload } = await jose.jwtVerify(token, secret);\n      return payload as AuthTokenPayload<TAuthInfo>;\n    } catch (err) {\n      if (err != null && typeof err === \"object\" && \"code\" in err && err.code === \"ERR_JWT_EXPIRED\") {\n        throw new Error(\"\uD1A0\uD070\uC774 \uB9CC\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4.\");\n      }\n      throw new Error(\"\uC720\uD6A8\uD558\uC9C0 \uC54A\uC740 \uD1A0\uD070\uC785\uB2C8\uB2E4.\");\n    }\n  }\n\n  decode(token: string): AuthTokenPayload<TAuthInfo> {\n    const jwtSecret = this._server.options.auth?.jwtSecret;\n    if (jwtSecret == null) throw new Error(\"JWT Secret\uC774 \uC815\uC758\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.\");\n\n    return jose.decodeJwt(token) as AuthTokenPayload<TAuthInfo>;\n  }\n}\n"],
   "mappings": "AACA,YAAY,UAAU;AAGf,MAAM,WAAgC;AAAA,EAC3C,YAA6B,SAAmC;AAAnC;AAAA,EAAoC;AAAA,EAEjE,MAAM,KAAK,SAAuD;AAChE,UAAM,YAAY,KAAK,QAAQ,QAAQ,MAAM;AAC7C,QAAI,aAAa,KAAM,OAAM,IAAI,MAAM,2EAAyB;AAEhE,UAAM,SAAS,IAAI,YAAY,EAAE,OAAO,SAAS;AAEjD,WAAO,IAAI,KAAK,QAAQ,OAAO,EAC5B,mBAAmB,EAAE,KAAK,QAAQ,CAAC,EACnC,YAAY,EACZ,kBAAkB,KAAK,EACvB,KAAK,MAAM;AAAA,EAChB;AAAA,EAEA,MAAM,OAAO,OAAqD;AAChE,UAAM,YAAY,KAAK,QAAQ,QAAQ,MAAM;AAC7C,QAAI,aAAa,KAAM,OAAM,IAAI,MAAM,2EAAyB;AAEhE,UAAM,SAAS,IAAI,YAAY,EAAE,OAAO,SAAS;AAEjD,QAAI;AACF,YAAM,EAAE,QAAQ,IAAI,MAAM,KAAK,UAAU,OAAO,MAAM;AACtD,aAAO;AAAA,IACT,SAAS,KAAK;AACZ,UAAI,OAAO,QAAQ,OAAO,QAAQ,YAAY,UAAU,OAAO,IAAI,SAAS,mBAAmB;AAC7F,cAAM,IAAI,MAAM,gEAAc;AAAA,MAChC;AACA,YAAM,IAAI,MAAM,uEAAgB;AAAA,IAClC;AAAA,EACF;AAAA,EAEA,OAAO,OAA4C;AACjD,UAAM,YAAY,KAAK,QAAQ,QAAQ,MAAM;AAC7C,QAAI,aAAa,KAAM,OAAM,IAAI,MAAM,2EAAyB;AAEhE,WAAO,KAAK,UAAU,KAAK;AAAA,EAC7B;AACF;",
   "names": []
 }

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

@@ -0,0 +1,67 @@
+import type { ServiceServer } from "../service-server";
+import type { ServiceSocket } from "../transport/socket/service-socket";
+import type { AuthTokenPayload } from "../auth/auth-token-payload";
+export interface ServiceContext<TAuthInfo = unknown> {
+    server: ServiceServer<TAuthInfo>;
+    socket?: ServiceSocket;
+    http?: {
+        clientName: string;
+        authTokenPayload?: AuthTokenPayload<TAuthInfo>;
+    };
+    /** V1 legacy context (auto-update only) */
+    legacy?: {
+        clientName?: string;
+    };
+    get authInfo(): TAuthInfo | undefined;
+    get clientName(): string | undefined;
+    get clientPath(): string | undefined;
+    getConfig<T>(section: string): Promise<T>;
+}
+export declare function createServiceContext<TAuthInfo = unknown>(server: ServiceServer<TAuthInfo>, socket?: ServiceSocket, http?: {
+    clientName: string;
+    authTokenPayload?: AuthTokenPayload<TAuthInfo>;
+}, legacy?: {
+    clientName?: string;
+}): ServiceContext<TAuthInfo>;
+/** Read auth permissions from an auth()-wrapped function. Returns undefined if not wrapped. */
+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)`
+ */
+export declare function auth<T extends (...args: any[]) => any>(fn: T): T;
+export declare function auth<T extends (...args: any[]) => any>(permissions: string[], fn: T): T;
+export interface ServiceDefinition<TMethods = Record<string, (...args: any[]) => any>> {
+    name: string;
+    factory: (ctx: ServiceContext) => TMethods;
+    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"),
+ * })));
+ */
+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.
+ *
+ * @example
+ * export type UserServiceType = ServiceMethods<typeof UserService>;
+ * // Client: client.getService<UserServiceType>("User");
+ */
+export type ServiceMethods<T> = T extends ServiceDefinition<infer M> ? M : never;
+//# sourceMappingURL=define-service.d.ts.map

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

@@ -0,0 +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,CAkD3B;AAMD,+FAA+F;AAC/F,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,EAAE,GAAG,SAAS,CAE5E;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;AAClE,wBAAgB,IAAI,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;AAczF,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,CAAC,IAAI,CAAC,SAAS,iBAAiB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC"}

package/dist/core/define-service.js

@@ -0,0 +1,70 @@
+import { objMerge } from "@simplysm/core-common";
+import { ConfigManager } 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(`\uC720\uD6A8\uD558\uC9C0 \uC54A\uC740 \uD074\uB77C\uC774\uC5B8\uD2B8 \uBA85\uC785\uB2C8\uB2E4: ${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 ConfigManager.getConfig(rootFilePath);
+      if (rootConfig != null) {
+        configParent = rootConfig;
+      }
+      const targetPath = this.clientPath;
+      if (targetPath != null) {
+        const clientFilePath = path.resolve(targetPath, ".config.json");
+        const clientConfig = await ConfigManager.getConfig(clientFilePath);
+        if (clientConfig != null) {
+          configParent = objMerge(configParent, clientConfig);
+        }
+      }
+      const config = configParent[section];
+      if (config == null) throw new Error(`\uC124\uC815 \uC139\uC158\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${section}`);
+      return config;
+    }
+  };
+}
+const AUTH_PERMISSIONS = /* @__PURE__ */ Symbol("authPermissions");
+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;
+}
+function defineService(name, factory) {
+  return {
+    name,
+    factory,
+    authPermissions: getServiceAuthPermissions(factory)
+  };
+}
+export {
+  auth,
+  createServiceContext,
+  defineService,
+  getServiceAuthPermissions
+};
+//# sourceMappingURL=define-service.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/core/define-service.ts"],
+  "mappings": "AAGA,SAAS,gBAAgB;AACzB,SAAS,qBAAqB;AAC9B,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,IACpE;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,kGAAuB,IAAI,EAAE;AAAA,MAC/C;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,cAAc,UAA6B,YAAY;AAChF,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,cAAc,UAA6B,cAAc;AACpF,YAAI,gBAAgB,MAAM;AACxB,yBAAe,SAAS,cAAc,YAAY;AAAA,QACpD;AAAA,MACF;AAEA,YAAM,SAAS,aAAa,OAAO;AACnC,UAAI,UAAU,KAAM,OAAM,IAAI,MAAM,iFAAqB,OAAO,EAAE;AAClE,aAAO;AAAA,IACT;AAAA,EACF;AACF;AAIA,MAAM,mBAAmB,uBAAO,iBAAiB;AAG1C,SAAS,0BAA0B,IAAoC;AAC5E,SAAQ,GAA0C,gBAAgB;AACpE;AAYO,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": []
+}

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,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa;IAE7C,SAAS,CAAC,GAAG,EAAE;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,OAAO,EAAE,CAAC;QAClB,MAAM,CAAC,EAAE,aAAa,CAAC;QACvB,IAAI,CAAC,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;SAAE,CAAC;KACpE,GAAG,OAAO,CAAC,OAAO,CAAC;CAuDrB"}
+{"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,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa;IAE7C,SAAS,CAAC,GAAG,EAAE;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,OAAO,EAAE,CAAC;QAClB,MAAM,CAAC,EAAE,aAAa,CAAC;QACvB,IAAI,CAAC,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;SAAE,CAAC;KACpE,GAAG,OAAO,CAAC,OAAO,CAAC;CAqDrB"}

package/dist/core/service-executor.js

@@ -1,11 +1,11 @@
-import { getAuthPermissions } from "../auth/auth.decorators.js";
+import { createServiceContext, getServiceAuthPermissions } from "./define-service.js";
 class ServiceExecutor {
   constructor(_server) {
     this._server = _server;
   }
   async runMethod(def) {
-    const ServiceClass = this._server.options.services.find((item) => item.name === def.serviceName);
-    if (ServiceClass == null) {
+    const serviceDef = this._server.options.services.find((item) => item.name === def.serviceName);
+    if (serviceDef == null) {
       throw new Error(`\uC11C\uBE44\uC2A4[${def.serviceName}]\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`);
     }
     const clientName = def.socket?.clientName ?? def.http?.clientName;
@@ -14,8 +14,15 @@ class ServiceExecutor {
         throw new Error(`[Security] \uC720\uD6A8\uD558\uC9C0 \uC54A\uC740 \uD074\uB77C\uC774\uC5B8\uD2B8\uBA85\uC785\uB2C8\uB2E4: ${clientName}`);
       }
     }
+    const ctx = createServiceContext(this._server, def.socket, def.http);
+    const methods = serviceDef.factory(ctx);
+    const method = methods[def.methodName];
+    if (typeof method !== "function") {
+      throw new Error(`\uBA54\uC18C\uB4DC[${def.serviceName}.${def.methodName}]\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`);
+    }
     if (this._server.options.auth != null) {
-      const requiredPerms = getAuthPermissions(ServiceClass, def.methodName);
+      const methodPerms = getServiceAuthPermissions(method);
+      const requiredPerms = methodPerms ?? serviceDef.authPermissions;
       if (requiredPerms != null) {
         const authTokenPayload = def.socket?.authTokenPayload ?? def.http?.authTokenPayload;
         if (authTokenPayload == null) {
@@ -29,15 +36,7 @@ class ServiceExecutor {
         }
       }
     }
-    const service = new ServiceClass();
-    service.server = this._server;
-    service.socket = def.socket;
-    service.http = def.http;
-    const method = service[def.methodName];
-    if (typeof method !== "function") {
-      throw new Error(`\uBA54\uC18C\uB4DC[${def.serviceName}.${def.methodName}]\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`);
-    }
-    return await method.apply(service, def.params);
+    return await method(...def.params);
   }
 }
 export {

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

@@ -1,7 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/core/service-executor.ts"],
-  "sourcesContent": ["import type { ServiceServer } from \"../service-server\";\nimport type { ServiceSocket } from \"../transport/socket/service-socket\";\nimport type { AuthTokenPayload } from \"../auth/auth-token-payload\";\nimport { getAuthPermissions } from \"../auth/auth.decorators\";\n\nexport class ServiceExecutor {\n  constructor(private readonly _server: ServiceServer) {}\n\n  async runMethod(def: {\n    serviceName: string;\n    methodName: string;\n    params: unknown[];\n    socket?: ServiceSocket;\n    http?: { clientName: string; authTokenPayload?: AuthTokenPayload };\n  }): Promise<unknown> {\n    // \uC11C\uBE44\uC2A4 \uD074\uB798\uC2A4 \uCC3E\uAE30\n    const ServiceClass = this._server.options.services.find((item) => item.name === def.serviceName);\n\n    if (ServiceClass == null) {\n      throw new Error(`\uC11C\uBE44\uC2A4[${def.serviceName}]\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`);\n    }\n\n    // \uC694\uCCAD \uAC80\uC99D (Gatekeeper)\n    const clientName = def.socket?.clientName ?? def.http?.clientName;\n    if (clientName != null) {\n      if (clientName.includes(\"..\") || clientName.includes(\"/\") || clientName.includes(\"\\\\\")) {\n        throw new Error(`[Security] \uC720\uD6A8\uD558\uC9C0 \uC54A\uC740 \uD074\uB77C\uC774\uC5B8\uD2B8\uBA85\uC785\uB2C8\uB2E4: ${clientName}`);\n      }\n    }\n\n    // \uC778\uC99D\uAC80\uC0AC\n    if (this._server.options.auth != null) {\n      // \uBA54\uC18C\uB4DC \uB808\uBCA8 \u2192 \uD074\uB798\uC2A4 \uB808\uBCA8 \uC21C\uC73C\uB85C \uAD8C\uD55C \uD655\uC778\n      const requiredPerms = getAuthPermissions(ServiceClass, def.methodName);\n\n      // \uAD8C\uD55C \uC124\uC815\uC774 \uC788\uC73C\uBA74 \uC778\uC99D \uD544\uC694\n      if (requiredPerms != null) {\n        const authTokenPayload = def.socket?.authTokenPayload ?? def.http?.authTokenPayload;\n\n        // \uAD8C\uD55C\uC774 \uD544\uC694\uD55C\uB370 \uC778\uC99D\uC815\uBCF4\uAC00 \uC5C6\uC73C\uBA74 \uC5D0\uB7EC\n        if (authTokenPayload == null) {\n          throw new Error(\"\uB85C\uADF8\uC778\uC774 \uD544\uC694\uD569\uB2C8\uB2E4.\");\n        }\n\n        // \uAD8C\uD55C \uBAA9\uB85D \uCCB4\uD06C (\uBE48 \uBC30\uC5F4\uC774\uBA74 \uB85C\uADF8\uC778\uB9CC \uCCB4\uD06C)\n        if (requiredPerms.length > 0) {\n          const hasPerm = requiredPerms.some((perm) => authTokenPayload.roles.includes(perm));\n          if (!hasPerm) {\n            throw new Error(\"\uAD8C\uD55C\uC774 \uBD80\uC871\uD569\uB2C8\uB2E4.\");\n          }\n        }\n      }\n    }\n\n    // \uC11C\uBE44\uC2A4 \uC778\uC2A4\uD134\uC2A4 \uC0DD\uC131 (Context \uC8FC\uC785)\n    const service = new ServiceClass();\n    service.server = this._server;\n    service.socket = def.socket;\n    service.http = def.http;\n\n    // \uBA54\uC18C\uB4DC \uCC3E\uAE30\n    const method = (service as unknown as Record<string, unknown>)[def.methodName];\n    if (typeof method !== \"function\") {\n      throw new Error(`\uBA54\uC18C\uB4DC[${def.serviceName}.${def.methodName}]\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`);\n    }\n\n    // \uC2E4\uD589\n    return await method.apply(service, def.params);\n  }\n}\n"],
-  "mappings": "AAGA,SAAS,0BAA0B;AAE5B,MAAM,gBAAgB;AAAA,EAC3B,YAA6B,SAAwB;AAAxB;AAAA,EAAyB;AAAA,EAEtD,MAAM,UAAU,KAMK;AAEnB,UAAM,eAAe,KAAK,QAAQ,QAAQ,SAAS,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,WAAW;AAE/F,QAAI,gBAAgB,MAAM;AACxB,YAAM,IAAI,MAAM,sBAAO,IAAI,WAAW,uDAAe;AAAA,IACvD;AAGA,UAAM,aAAa,IAAI,QAAQ,cAAc,IAAI,MAAM;AACvD,QAAI,cAAc,MAAM;AACtB,UAAI,WAAW,SAAS,IAAI,KAAK,WAAW,SAAS,GAAG,KAAK,WAAW,SAAS,IAAI,GAAG;AACtF,cAAM,IAAI,MAAM,4GAAiC,UAAU,EAAE;AAAA,MAC/D;AAAA,IACF;AAGA,QAAI,KAAK,QAAQ,QAAQ,QAAQ,MAAM;AAErC,YAAM,gBAAgB,mBAAmB,cAAc,IAAI,UAAU;AAGrE,UAAI,iBAAiB,MAAM;AACzB,cAAM,mBAAmB,IAAI,QAAQ,oBAAoB,IAAI,MAAM;AAGnE,YAAI,oBAAoB,MAAM;AAC5B,gBAAM,IAAI,MAAM,0DAAa;AAAA,QAC/B;AAGA,YAAI,cAAc,SAAS,GAAG;AAC5B,gBAAM,UAAU,cAAc,KAAK,CAAC,SAAS,iBAAiB,MAAM,SAAS,IAAI,CAAC;AAClF,cAAI,CAAC,SAAS;AACZ,kBAAM,IAAI,MAAM,oDAAY;AAAA,UAC9B;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAGA,UAAM,UAAU,IAAI,aAAa;AACjC,YAAQ,SAAS,KAAK;AACtB,YAAQ,SAAS,IAAI;AACrB,YAAQ,OAAO,IAAI;AAGnB,UAAM,SAAU,QAA+C,IAAI,UAAU;AAC7E,QAAI,OAAO,WAAW,YAAY;AAChC,YAAM,IAAI,MAAM,sBAAO,IAAI,WAAW,IAAI,IAAI,UAAU,uDAAe;AAAA,IACzE;AAGA,WAAO,MAAM,OAAO,MAAM,SAAS,IAAI,MAAM;AAAA,EAC/C;AACF;",
+  "mappings": "AAGA,SAAS,sBAAsB,iCAAiC;AAEzD,MAAM,gBAAgB;AAAA,EAC3B,YAA6B,SAAwB;AAAxB;AAAA,EAAyB;AAAA,EAEtD,MAAM,UAAU,KAMK;AAEnB,UAAM,aAAa,KAAK,QAAQ,QAAQ,SAAS,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,WAAW;AAE7F,QAAI,cAAc,MAAM;AACtB,YAAM,IAAI,MAAM,sBAAO,IAAI,WAAW,uDAAe;AAAA,IACvD;AAGA,UAAM,aAAa,IAAI,QAAQ,cAAc,IAAI,MAAM;AACvD,QAAI,cAAc,MAAM;AACtB,UAAI,WAAW,SAAS,IAAI,KAAK,WAAW,SAAS,GAAG,KAAK,WAAW,SAAS,IAAI,GAAG;AACtF,cAAM,IAAI,MAAM,4GAAiC,UAAU,EAAE;AAAA,MAC/D;AAAA,IACF;AAGA,UAAM,MAAM,qBAAqB,KAAK,SAAS,IAAI,QAAQ,IAAI,IAAI;AAGnE,UAAM,UAAU,WAAW,QAAQ,GAAG;AAGtC,UAAM,SAAU,QAAoC,IAAI,UAAU;AAClE,QAAI,OAAO,WAAW,YAAY;AAChC,YAAM,IAAI,MAAM,sBAAO,IAAI,WAAW,IAAI,IAAI,UAAU,uDAAe;AAAA,IACzE;AAGA,QAAI,KAAK,QAAQ,QAAQ,QAAQ,MAAM;AAErC,YAAM,cAAc,0BAA0B,MAAM;AACpD,YAAM,gBAAgB,eAAe,WAAW;AAEhD,UAAI,iBAAiB,MAAM;AACzB,cAAM,mBAAmB,IAAI,QAAQ,oBAAoB,IAAI,MAAM;AAEnE,YAAI,oBAAoB,MAAM;AAC5B,gBAAM,IAAI,MAAM,0DAAa;AAAA,QAC/B;AAEA,YAAI,cAAc,SAAS,GAAG;AAC5B,gBAAM,UAAU,cAAc,KAAK,CAAC,SAAS,iBAAiB,MAAM,SAAS,IAAI,CAAC;AAClF,cAAI,CAAC,SAAS;AACZ,kBAAM,IAAI,MAAM,oDAAY;AAAA,UAC9B;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAGA,WAAO,MAAM,OAAO,GAAG,IAAI,MAAM;AAAA,EACnC;AACF;",
   "names": []
 }

package/dist/index.d.ts

@@ -1,8 +1,7 @@
 export * from "./types/server-options";
-export * from "./auth/auth.decorators";
 export * from "./auth/auth-token-payload";
 export * from "./auth/jwt-manager";
-export * from "./core/service-base";
+export * from "./core/define-service";
 export * from "./core/service-executor";
 export * from "./transport/socket/websocket-handler";
 export * from "./transport/socket/service-socket";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,wBAAwB,CAAC;AAGvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AAGnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,sCAAsC,CAAC;AACrD,cAAc,mCAAmC,CAAC;AAGlD,cAAc,uCAAuC,CAAC;AACtD,cAAc,iCAAiC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AAGrD,cAAc,6BAA6B,CAAC;AAG5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAG/C,cAAc,wBAAwB,CAAC;AAGvC,cAAc,iCAAiC,CAAC;AAGhD,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,wBAAwB,CAAC;AAGvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AAGnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,sCAAsC,CAAC;AACrD,cAAc,mCAAmC,CAAC;AAGlD,cAAc,uCAAuC,CAAC;AACtD,cAAc,iCAAiC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AAGrD,cAAc,6BAA6B,CAAC;AAG5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAG/C,cAAc,wBAAwB,CAAC;AAGvC,cAAc,iCAAiC,CAAC;AAGhD,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,8 +1,7 @@
 export * from "./types/server-options.js";
-export * from "./auth/auth.decorators.js";
 export * from "./auth/auth-token-payload.js";
 export * from "./auth/jwt-manager.js";
-export * from "./core/service-base.js";
+export * from "./core/define-service.js";
 export * from "./core/service-executor.js";
 export * from "./transport/socket/websocket-handler.js";
 export * from "./transport/socket/service-socket.js";

package/dist/index.js.map

@@ -1,7 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "sourcesContent": ["// Types\nexport * from \"./types/server-options\";\n\n// Auth\nexport * from \"./auth/auth.decorators\";\nexport * from \"./auth/auth-token-payload\";\nexport * from \"./auth/jwt-manager\";\n\n// Core\nexport * from \"./core/service-base\";\nexport * from \"./core/service-executor\";\n\n// Transport - Socket\nexport * from \"./transport/socket/websocket-handler\";\nexport * from \"./transport/socket/service-socket\";\n\n// Transport - HTTP\nexport * from \"./transport/http/http-request-handler\";\nexport * from \"./transport/http/upload-handler\";\nexport * from \"./transport/http/static-file-handler\";\n\n// Protocol\nexport * from \"./protocol/protocol-wrapper\";\n\n// Services\nexport * from \"./services/orm-service\";\nexport * from \"./services/crypto-service\";\nexport * from \"./services/smtp-service\";\nexport * from \"./services/auto-update-service\";\n\n// Utils\nexport * from \"./utils/config-manager\";\n\n// Legacy\nexport * from \"./legacy/v1-auto-update-handler\";\n\n// Main\nexport * from \"./service-server\";\n"],
-  "mappings": "AACA,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AAGd,cAAc;AACd,cAAc;AAGd,cAAc;AACd,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AAGd,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAGd,cAAc;AAGd,cAAc;AAGd,cAAc;",
+  "mappings": "AACA,cAAc;AAGd,cAAc;AACd,cAAc;AAGd,cAAc;AACd,cAAc;AAGd,cAAc;AACd,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AAGd,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAGd,cAAc;AAGd,cAAc;AAGd,cAAc;",
   "names": []
 }

package/dist/legacy/v1-auto-update-handler.d.ts

@@ -1,8 +1,9 @@
 import type { WebSocket } from "ws";
-import type { AutoUpdateService } from "../services/auto-update-service";
 /**
  * V1 레거시 클라이언트 처리 (auto-update만 지원)
  * 다른 모든 요청은 업그레이드 유도 에러를 반환합니다.
  */
-export declare function handleV1Connection(socket: WebSocket, autoUpdateService: AutoUpdateService): void;
+export declare function handleV1Connection(socket: WebSocket, autoUpdateMethods: {
+    getLastVersion: (platform: string) => Promise<any>;
+}, clientNameSetter?: (clientName: string | undefined) => void): void;
 //# sourceMappingURL=v1-auto-update-handler.d.ts.map

package/dist/legacy/v1-auto-update-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v1-auto-update-handler.d.ts","sourceRoot":"","sources":["../../src/legacy/v1-auto-update-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAmBzE;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAAE,iBAAiB,QAuCzF"}
+{"version":3,"file":"v1-auto-update-handler.d.ts","sourceRoot":"","sources":["../../src/legacy/v1-auto-update-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAmBpC;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EACjB,iBAAiB,EAAE;IAAE,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;CAAE,EACzE,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,QAwC5D"}

package/dist/legacy/v1-auto-update-handler.js

@@ -1,13 +1,13 @@
 import consola from "consola";
 const logger = consola.withTag("service-server:V1AutoUpdateHandler");
-function handleV1Connection(socket, autoUpdateService) {
+function handleV1Connection(socket, autoUpdateMethods, clientNameSetter) {
   socket.send(JSON.stringify({ name: "connected" }));
   socket.on("message", (data) => {
     try {
       const msg = JSON.parse(data.toString());
       if (msg.command === "SdAutoUpdateService.getLastVersion") {
-        autoUpdateService.legacy = { clientName: msg.clientName };
-        const result = autoUpdateService.getLastVersion(msg.params[0]);
+        clientNameSetter?.(msg.clientName);
+        const result = autoUpdateMethods.getLastVersion(msg.params[0]);
         const response = {
           name: "response",
           reqUuid: msg.uuid,

package/dist/legacy/v1-auto-update-handler.js.map

@@ -1,7 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/legacy/v1-auto-update-handler.ts"],
-  "sourcesContent": ["import type { WebSocket } from \"ws\";\nimport type { AutoUpdateService } from \"../services/auto-update-service\";\nimport consola from \"consola\";\n\nconst logger = consola.withTag(\"service-server:V1AutoUpdateHandler\");\n\ninterface IV1Request {\n  uuid: string;\n  command: string;\n  params: unknown[];\n  clientName?: string;\n}\n\ninterface IV1Response {\n  name: \"response\";\n  reqUuid: string;\n  state: \"success\" | \"error\";\n  body: unknown;\n}\n\n/**\n * V1 \uB808\uAC70\uC2DC \uD074\uB77C\uC774\uC5B8\uD2B8 \uCC98\uB9AC (auto-update\uB9CC \uC9C0\uC6D0)\n * \uB2E4\uB978 \uBAA8\uB4E0 \uC694\uCCAD\uC740 \uC5C5\uADF8\uB808\uC774\uB4DC \uC720\uB3C4 \uC5D0\uB7EC\uB97C \uBC18\uD658\uD569\uB2C8\uB2E4.\n */\nexport function handleV1Connection(socket: WebSocket, autoUpdateService: AutoUpdateService) {\n  // \uC5F0\uACB0 \uC644\uB8CC \uC54C\uB9BC\n  socket.send(JSON.stringify({ name: \"connected\" }));\n\n  socket.on(\"message\", (data) => {\n    try {\n      const msg = JSON.parse(data.toString()) as IV1Request;\n\n      // SdAutoUpdateService.getLastVersion\uB9CC \uD5C8\uC6A9\n      if (msg.command === \"SdAutoUpdateService.getLastVersion\") {\n        // legacy \uCEE8\uD14D\uC2A4\uD2B8 \uC124\uC815\n        autoUpdateService.legacy = { clientName: msg.clientName };\n\n        const result = autoUpdateService.getLastVersion(msg.params[0] as string);\n\n        const response: IV1Response = {\n          name: \"response\",\n          reqUuid: msg.uuid,\n          state: \"success\",\n          body: result,\n        };\n        socket.send(JSON.stringify(response));\n      } else {\n        // \uB2E4\uB978 \uBAA8\uB4E0 \uC694\uCCAD\uC740 \uC5C5\uADF8\uB808\uC774\uB4DC \uC720\uB3C4\n        const response: IV1Response = {\n          name: \"response\",\n          reqUuid: msg.uuid,\n          state: \"error\",\n          body: {\n            message: \"\uC571 \uC5C5\uB370\uC774\uD2B8\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4.\",\n            code: \"UPGRADE_REQUIRED\",\n          },\n        };\n        socket.send(JSON.stringify(response));\n      }\n    } catch (err) {\n      logger.warn(\"V1 \uBA54\uC2DC\uC9C0 \uCC98\uB9AC \uC624\uB958\", err);\n    }\n  });\n}\n"],
-  "mappings": "AAEA,OAAO,aAAa;AAEpB,MAAM,SAAS,QAAQ,QAAQ,oCAAoC;AAoB5D,SAAS,mBAAmB,QAAmB,mBAAsC;AAE1F,SAAO,KAAK,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC,CAAC;AAEjD,SAAO,GAAG,WAAW,CAAC,SAAS;AAC7B,QAAI;AACF,YAAM,MAAM,KAAK,MAAM,KAAK,SAAS,CAAC;AAGtC,UAAI,IAAI,YAAY,sCAAsC;AAExD,0BAAkB,SAAS,EAAE,YAAY,IAAI,WAAW;AAExD,cAAM,SAAS,kBAAkB,eAAe,IAAI,OAAO,CAAC,CAAW;AAEvE,cAAM,WAAwB;AAAA,UAC5B,MAAM;AAAA,UACN,SAAS,IAAI;AAAA,UACb,OAAO;AAAA,UACP,MAAM;AAAA,QACR;AACA,eAAO,KAAK,KAAK,UAAU,QAAQ,CAAC;AAAA,MACtC,OAAO;AAEL,cAAM,WAAwB;AAAA,UAC5B,MAAM;AAAA,UACN,SAAS,IAAI;AAAA,UACb,OAAO;AAAA,UACP,MAAM;AAAA,YACJ,SAAS;AAAA,YACT,MAAM;AAAA,UACR;AAAA,QACF;AACA,eAAO,KAAK,KAAK,UAAU,QAAQ,CAAC;AAAA,MACtC;AAAA,IACF,SAAS,KAAK;AACZ,aAAO,KAAK,mDAAgB,GAAG;AAAA,IACjC;AAAA,EACF,CAAC;AACH;",
+  "mappings": "AACA,OAAO,aAAa;AAEpB,MAAM,SAAS,QAAQ,QAAQ,oCAAoC;AAoB5D,SAAS,mBACd,QACA,mBACA,kBACA;AAEA,SAAO,KAAK,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC,CAAC;AAEjD,SAAO,GAAG,WAAW,CAAC,SAAS;AAC7B,QAAI;AACF,YAAM,MAAM,KAAK,MAAM,KAAK,SAAS,CAAC;AAGtC,UAAI,IAAI,YAAY,sCAAsC;AAExD,2BAAmB,IAAI,UAAU;AAEjC,cAAM,SAAS,kBAAkB,eAAe,IAAI,OAAO,CAAC,CAAW;AAEvE,cAAM,WAAwB;AAAA,UAC5B,MAAM;AAAA,UACN,SAAS,IAAI;AAAA,UACb,OAAO;AAAA,UACP,MAAM;AAAA,QACR;AACA,eAAO,KAAK,KAAK,UAAU,QAAQ,CAAC;AAAA,MACtC,OAAO;AAEL,cAAM,WAAwB;AAAA,UAC5B,MAAM;AAAA,UACN,SAAS,IAAI;AAAA,UACb,OAAO;AAAA,UACP,MAAM;AAAA,YACJ,SAAS;AAAA,YACT,MAAM;AAAA,UACR;AAAA,QACF;AACA,eAAO,KAAK,KAAK,UAAU,QAAQ,CAAC;AAAA,MACtC;AAAA,IACF,SAAS,KAAK;AACZ,aAAO,KAAK,mDAAgB,GAAG;AAAA,IACjC;AAAA,EACF,CAAC;AACH;",
   "names": []
 }

package/dist/protocol/protocol-wrapper.js.map

@@ -1,7 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/protocol/protocol-wrapper.ts"],
-  "sourcesContent": ["import type { Bytes } from \"@simplysm/core-common\";\nimport { Worker, type WorkerProxy } from \"@simplysm/core-node\";\nimport type { ServiceMessageDecodeResult, ServiceMessage } from \"@simplysm/service-common\";\nimport { ServiceProtocol } from \"@simplysm/service-common\";\nimport type * as ServiceProtocolWorkerModule from \"../workers/service-protocol.worker\";\n\nexport class ProtocolWrapper {\n  // \uC6CC\uCEE4 \uC2A4\uB808\uB4DC (\uBB34\uAC70\uC6B4 \uC791\uC5C5\uC6A9, Static Lazy Singleton)\n  private static _worker?: WorkerProxy<typeof ServiceProtocolWorkerModule>;\n  private static get worker() {\n    if (this._worker == null) {\n      this._worker = Worker.create<typeof ServiceProtocolWorkerModule>(\n        import.meta.resolve(\"../workers/service-protocol.worker\"),\n        {\n          resourceLimits: { maxOldGenerationSizeMb: 4096 },\n        },\n      );\n    }\n    return this._worker;\n  }\n\n  // \uBA54\uC778 \uC2A4\uB808\uB4DC\uC6A9 \uD504\uB85C\uD1A0\uCF5C \uC778\uC2A4\uD134\uC2A4 (\uAC00\uBCBC\uC6B4 \uC791\uC5C5\uC6A9)\n  private readonly _protocol = new ServiceProtocol();\n\n  // \uAE30\uC900\uAC12 \uC124\uC815\n  private readonly _SIZE_THRESHOLD = 30 * 1024; // 30KB\n\n  /**\n   * \uBA54\uC2DC\uC9C0 \uC778\uCF54\uB529 (\uC790\uB3D9 \uBD84\uAE30 \uCC98\uB9AC)\n   */\n  async encode(uuid: string, message: ServiceMessage): Promise<{ chunks: Bytes[]; totalSize: number }> {\n    if (this._shouldUseWorkerForEncode(message)) {\n      return ProtocolWrapper.worker.encode(uuid, message);\n    } else {\n      return this._protocol.encode(uuid, message);\n    }\n  }\n\n  /**\n   * \uBA54\uC2DC\uC9C0 \uB514\uCF54\uB529 (\uC790\uB3D9 \uBD84\uAE30 \uCC98\uB9AC)\n   */\n  async decode(bytes: Bytes): Promise<ServiceMessageDecodeResult<ServiceMessage>> {\n    const totalSize = bytes.length;\n    if (totalSize > this._SIZE_THRESHOLD) {\n      return ProtocolWrapper.worker.decode(bytes);\n    } else {\n      return this._protocol.decode(bytes);\n    }\n  }\n\n  /**\n   * \uC6CC\uCEE4 \uC0AC\uC6A9 \uC5EC\uBD80 \uD310\uB2E8 \uB85C\uC9C1 (Encode)\n   */\n  private _shouldUseWorkerForEncode(msg: ServiceMessage): boolean {\n    if (!(\"body\" in msg)) return false;\n\n    const body = msg.body;\n\n    // Uint8Array: \uD06C\uAE30 \uD655\uC778\n    if (body instanceof Uint8Array) {\n      return true;\n    }\n\n    // Array: \uAE38\uC774 \uD655\uC778 (ORM \uACB0\uACFC \uB4F1)\n    if (Array.isArray(body)) {\n      return body.length > 0 && body.some((item) => item instanceof Uint8Array);\n    }\n\n    return false;\n  }\n\n  dispose() {\n    this._protocol.dispose();\n  }\n}\n"],
   "mappings": "AACA,SAAS,cAAgC;AAEzC,SAAS,uBAAuB;AAGzB,MAAM,gBAAgB;AAAA;AAAA,EAE3B,OAAe;AAAA,EACf,WAAmB,SAAS;AAC1B,QAAI,KAAK,WAAW,MAAM;AACxB,WAAK,UAAU,OAAO;AAAA,QACpB,YAAY,QAAQ,oCAAoC;AAAA,QACxD;AAAA,UACE,gBAAgB,EAAE,wBAAwB,KAAK;AAAA,QACjD;AAAA,MACF;AAAA,IACF;AACA,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGiB,YAAY,IAAI,gBAAgB;AAAA;AAAA,EAGhC,kBAAkB,KAAK;AAAA;AAAA;AAAA;AAAA;AAAA,EAKxC,MAAM,OAAO,MAAc,SAA0E;AACnG,QAAI,KAAK,0BAA0B,OAAO,GAAG;AAC3C,aAAO,gBAAgB,OAAO,OAAO,MAAM,OAAO;AAAA,IACpD,OAAO;AACL,aAAO,KAAK,UAAU,OAAO,MAAM,OAAO;AAAA,IAC5C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,OAAO,OAAmE;AAC9E,UAAM,YAAY,MAAM;AACxB,QAAI,YAAY,KAAK,iBAAiB;AACpC,aAAO,gBAAgB,OAAO,OAAO,KAAK;AAAA,IAC5C,OAAO;AACL,aAAO,KAAK,UAAU,OAAO,KAAK;AAAA,IACpC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKQ,0BAA0B,KAA8B;AAC9D,QAAI,EAAE,UAAU,KAAM,QAAO;AAE7B,UAAM,OAAO,IAAI;AAGjB,QAAI,gBAAgB,YAAY;AAC9B,aAAO;AAAA,IACT;AAGA,QAAI,MAAM,QAAQ,IAAI,GAAG;AACvB,aAAO,KAAK,SAAS,KAAK,KAAK,KAAK,CAAC,SAAS,gBAAgB,UAAU;AAAA,IAC1E;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,UAAU;AACR,SAAK,UAAU,QAAQ;AAAA,EACzB;AACF;",
   "names": []
 }

package/dist/service-server.d.ts

@@ -1,5 +1,4 @@
-import type { ServiceEventListener } from "@simplysm/service-common";
-import type { Type } from "@simplysm/core-common";
+import type { ServiceEventDef } from "@simplysm/service-common";
 import { EventEmitter } from "@simplysm/core-common";
 import type { FastifyInstance } from "fastify";
 import type { AuthTokenPayload } from "./auth/auth-token-payload";
@@ -21,9 +20,10 @@ export declare class ServiceServer<TAuthInfo = unknown> extends EventEmitter<{
     listen(): Promise<void>;
     close(): Promise<void>;
     broadcastReload(clientName: string | undefined, changedFileSet: Set<string>): Promise<void>;
-    emitEvent<T extends ServiceEventListener<unknown, unknown>>(eventType: Type<T>, infoSelector: (item: T["$info"]) => boolean, data: T["$data"]): Promise<void>;
+    emitEvent<TInfo, TData>(eventDef: ServiceEventDef<TInfo, TData>, infoSelector: (item: TInfo) => boolean, data: TData): Promise<void>;
     generateAuthToken(payload: AuthTokenPayload<TAuthInfo>): Promise<string>;
     verifyAuthToken(token: string): Promise<AuthTokenPayload<TAuthInfo>>;
     private _registerGracefulShutdown;
 }
+export declare function createServiceServer<TAuthInfo = unknown>(options: ServiceServerOptions): ServiceServer<TAuthInfo>;
 //# sourceMappingURL=service-server.d.ts.map

package/dist/service-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-server.d.ts","sourceRoot":"","sources":["../src/service-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAIrE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAA4B,YAAY,EAAO,MAAM,uBAAuB,CAAC;AACpF,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,SAAS,CAAC;AAa/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAOnE,qBAAa,aAAa,CAAC,SAAS,GAAG,OAAO,CAAE,SAAQ,YAAY,CAAC;IACnE,KAAK,EAAE,IAAI,CAAC;IACZ,KAAK,EAAE,IAAI,CAAC;CACb,CAAC;IAcY,QAAQ,CAAC,OAAO,EAAE,oBAAoB;IAblD,MAAM,UAAS;IAEf,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAC9D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmC;IAExD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAkE;IACtG,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA+B;IAClE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsC;IAErE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0D;IAErF,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;gBAEb,OAAO,EAAE,oBAAoB;IAY5C,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IA2HvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC;IAK3E,SAAS,CAAC,CAAC,SAAS,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,EAC9D,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,EAClB,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,OAAO,EAC3C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC;IAKZ,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC;IAItD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAI1E,OAAO,CAAC,yBAAyB;CAyBlC"}
+{"version":3,"file":"service-server.d.ts","sourceRoot":"","sources":["../src/service-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAIhE,OAAO,EAA4B,YAAY,EAAO,MAAM,uBAAuB,CAAC;AACpF,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,SAAS,CAAC;AAa/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAOnE,qBAAa,aAAa,CAAC,SAAS,GAAG,OAAO,CAAE,SAAQ,YAAY,CAAC;IACnE,KAAK,EAAE,IAAI,CAAC;IACZ,KAAK,EAAE,IAAI,CAAC;CACb,CAAC;IAcY,QAAQ,CAAC,OAAO,EAAE,oBAAoB;IAblD,MAAM,UAAS;IAEf,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAC9D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmC;IAExD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAkE;IACtG,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA+B;IAClE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsC;IAErE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0D;IAErF,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;gBAEb,OAAO,EAAE,oBAAoB;IAY5C,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAsIvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC;IAK3E,SAAS,CAAC,KAAK,EAAE,KAAK,EAC1B,QAAQ,EAAE,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,EACvC,YAAY,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,EACtC,IAAI,EAAE,KAAK;IAKP,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC;IAItD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAI1E,OAAO,CAAC,yBAAyB;CAyBlC;AAED,wBAAgB,mBAAmB,CAAC,SAAS,GAAG,OAAO,EAAE,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAAC,SAAS,CAAC,CAEhH"}

package/dist/service-server.js

@@ -14,7 +14,7 @@ import { UploadHandler } from "./transport/http/upload-handler.js";
 import { WebSocketHandler } from "./transport/socket/websocket-handler.js";
 import { JwtManager } from "./auth/jwt-manager.js";
 import { handleV1Connection } from "./legacy/v1-auto-update-handler.js";
-import { AutoUpdateService } from "./services/auto-update-service.js";
+import { createServiceContext } from "./core/define-service.js";
 import consola from "consola";
 const logger = consola.withTag("service-server:ServiceServer");
 class ServiceServer extends EventEmitter {
@@ -91,9 +91,16 @@ class ServiceServer extends EventEmitter {
         }
         this._wsHandler.addSocket(socket, clientId, clientName, req);
       } else {
-        const autoUpdateService = new AutoUpdateService();
-        autoUpdateService.server = this;
-        handleV1Connection(socket, autoUpdateService);
+        const autoUpdateDef = this.options.services.find((s) => s.name === "AutoUpdate");
+        if (autoUpdateDef == null) {
+          socket.close(1008, "AutoUpdate service not configured");
+          return;
+        }
+        const legacyCtx = createServiceContext(this, void 0, void 0, {});
+        const autoUpdateMethods = autoUpdateDef.factory(legacyCtx);
+        handleV1Connection(socket, autoUpdateMethods, (name) => {
+          legacyCtx.legacy = { clientName: name };
+        });
       }
     };
     this.fastify.get("/", { websocket: true }, onWebSocketConnected.bind(this));
@@ -127,8 +134,8 @@ class ServiceServer extends EventEmitter {
     logger.debug("\uC11C\uBC84\uB0B4 \uBAA8\uB4E0 \uD074\uB77C\uC774\uC5B8\uD2B8 RELOAD \uBA85\uB839 \uC804\uC1A1");
     await this._wsHandler.broadcastReload(clientName, changedFileSet);
   }
-  async emitEvent(eventType, infoSelector, data) {
-    await this._wsHandler.emitToServer(eventType, infoSelector, data);
+  async emitEvent(eventDef, infoSelector, data) {
+    await this._wsHandler.emitToServer(eventDef, infoSelector, data);
   }
   async generateAuthToken(payload) {
     return this._jwt.sign(payload);
@@ -159,7 +166,11 @@ class ServiceServer extends EventEmitter {
     process.on("SIGTERM", () => shutdownHandler("SIGTERM"));
   }
 }
+function createServiceServer(options) {
+  return new ServiceServer(options);
+}
 export {
-  ServiceServer
+  ServiceServer,
+  createServiceServer
 };
 //# sourceMappingURL=service-server.js.map