@simplysm/sd-claude 14.0.47 → 14.0.49

package/claude/references/sd-simplysm14/service-common/docs/protocol.md

@@ -1,331 +0,0 @@
-# Protocol
-
-## `PROTOCOL_CONFIG`
-
-서비스 프로토콜 설정 상수.
-
-```typescript
-export const PROTOCOL_CONFIG = {
-  MAX_TOTAL_SIZE: 100 * 1024 * 1024,   // 최대 메시지 크기 (100MB)
-  SPLIT_MESSAGE_SIZE: 3 * 1024 * 1024, // 청킹 임계값 (3MB)
-  CHUNK_SIZE: 300 * 1024,              // 청크 크기 (300KB)
-  GC_INTERVAL: 10 * 1000,             // GC 주기 (10초)
-  EXPIRE_TIME: 60 * 1000,             // 미완성 메시지 만료 시간 (60초)
-} as const;
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `MAX_TOTAL_SIZE` | `number` | 단일 메시지의 최대 허용 크기. 초과 시 `ArgumentError` 발생 |
-| `SPLIT_MESSAGE_SIZE` | `number` | 이 크기를 초과하면 자동으로 청크 분할 |
-| `CHUNK_SIZE` | `number` | 분할된 각 청크의 크기 |
-| `GC_INTERVAL` | `number` | 내부 청크 누적기의 가비지 컬렉션 주기 (밀리초) |
-| `EXPIRE_TIME` | `number` | 미완성 청크 메시지의 만료 시간. 이 시간 내에 모든 청크가 도착하지 않으면 제거 |
-
-## `ServiceMessage`
-
-모든 서비스 메시지의 유니언 타입. 클라이언트·서버 양방향 메시지를 모두 포함한다.
-
-```typescript
-export type ServiceMessage =
-  | ServiceRequestMessage
-  | ServiceAuthMessage
-  | ServiceProgressMessage
-  | ServiceResponseMessage
-  | ServiceErrorMessage
-  | ServiceAddEventListenerMessage
-  | ServiceRemoveEventListenerMessage
-  | ServiceGetEventListenerInfosMessage
-  | ServiceEmitEventMessage
-  | ServiceEventMessage;
-```
-
-## `ServiceServerMessage`
-
-서버 → 클라이언트 메시지 유니언.
-
-```typescript
-export type ServiceServerMessage =
-  | ServiceResponseMessage
-  | ServiceErrorMessage
-  | ServiceEventMessage;
-```
-
-## `ServiceServerRawMessage`
-
-서버가 보내는 모든 메시지 (진행 상태 포함).
-
-```typescript
-export type ServiceServerRawMessage = ServiceProgressMessage | ServiceServerMessage;
-```
-
-## `ServiceClientMessage`
-
-클라이언트 → 서버 메시지 유니언.
-
-```typescript
-export type ServiceClientMessage =
-  | ServiceRequestMessage
-  | ServiceAuthMessage
-  | ServiceAddEventListenerMessage
-  | ServiceRemoveEventListenerMessage
-  | ServiceGetEventListenerInfosMessage
-  | ServiceEmitEventMessage;
-```
-
-## `ServiceProgressMessage`
-
-서버가 보내는 청크 수신 진행 상태 알림 메시지.
-
-```typescript
-export interface ServiceProgressMessage {
-  name: "progress";
-  body: {
-    totalSize: number;
-    completedSize: number;
-  };
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `name` | `"progress"` | 고정 문자열 discriminant |
-| `body.totalSize` | `number` | 전체 메시지 크기 (바이트) |
-| `body.completedSize` | `number` | 현재까지 수신 완료된 크기 (바이트) |
-
-## `ServiceErrorMessage`
-
-서버가 보내는 에러 알림 메시지.
-
-```typescript
-export interface ServiceErrorMessage {
-  name: "error";
-  body: {
-    name: string;
-    message: string;
-    code: string;
-    stack?: string;
-    detail?: unknown;
-    cause?: unknown;
-  };
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `name` | `"error"` | 고정 문자열 discriminant |
-| `body.name` | `string` | 에러 이름 (클래스명) |
-| `body.message` | `string` | 에러 메시지 |
-| `body.code` | `string` | 에러 코드 |
-| `body.stack` | `string?` | 스택 트레이스 (선택) |
-| `body.detail` | `unknown?` | 추가 상세 정보 (선택) |
-| `body.cause` | `unknown?` | 원인 에러 (선택) |
-
-## `ServiceAuthMessage`
-
-클라이언트가 보내는 인증 메시지.
-
-```typescript
-export interface ServiceAuthMessage {
-  name: "auth";
-  body: string;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `name` | `"auth"` | 고정 문자열 discriminant |
-| `body` | `string` | 인증 토큰 |
-
-## `ServiceRequestMessage`
-
-클라이언트가 보내는 서비스 메서드 요청 메시지.
-
-```typescript
-export interface ServiceRequestMessage {
-  name: `${string}.${string}`;
-  body: unknown[];
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `name` | `` `${string}.${string}` `` | 서비스명.메서드명 형식 (예: `"OrmService.connect"`) |
-| `body` | `unknown[]` | 메서드 매개변수 배열 |
-
-## `ServiceResponseMessage`
-
-서버가 보내는 서비스 메서드 응답 메시지.
-
-```typescript
-export interface ServiceResponseMessage {
-  name: "response";
-  body?: unknown;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `name` | `"response"` | 고정 문자열 discriminant |
-| `body` | `unknown?` | 메서드 실행 결과 (없으면 void) |
-
-## `ServiceAddEventListenerMessage`
-
-클라이언트가 보내는 이벤트 리스너 추가 메시지.
-
-```typescript
-export interface ServiceAddEventListenerMessage {
-  name: "evt:add";
-  body: {
-    key: string;
-    name: string;
-    info: unknown;
-  };
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `name` | `"evt:add"` | 고정 문자열 discriminant |
-| `body.key` | `string` | 리스너 키 (UUID). removeEventListener에 사용 |
-| `body.name` | `string` | 이벤트 이름 (`ServiceEventDef.eventName`) |
-| `body.info` | `unknown` | 이벤트 발생 시 필터링을 위한 추가 리스너 정보 |
-
-## `ServiceRemoveEventListenerMessage`
-
-클라이언트가 보내는 이벤트 리스너 제거 메시지.
-
-```typescript
-export interface ServiceRemoveEventListenerMessage {
-  name: "evt:remove";
-  body: {
-    key: string;
-  };
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `name` | `"evt:remove"` | 고정 문자열 discriminant |
-| `body.key` | `string` | 제거할 리스너 키 (UUID) |
-
-## `ServiceGetEventListenerInfosMessage`
-
-클라이언트가 보내는 이벤트 리스너 정보 목록 요청 메시지.
-
-```typescript
-export interface ServiceGetEventListenerInfosMessage {
-  name: "evt:gets";
-  body: {
-    name: string;
-  };
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `name` | `"evt:gets"` | 고정 문자열 discriminant |
-| `body.name` | `string` | 조회할 이벤트 이름 |
-
-## `ServiceEmitEventMessage`
-
-클라이언트가 보내는 이벤트 발생 메시지.
-
-```typescript
-export interface ServiceEmitEventMessage {
-  name: "evt:emit";
-  body: {
-    keys: string[];
-    data: unknown;
-  };
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `name` | `"evt:emit"` | 고정 문자열 discriminant |
-| `body.keys` | `string[]` | 대상 리스너 키 목록 |
-| `body.data` | `unknown` | 이벤트 데이터 |
-
-## `ServiceEventMessage`
-
-서버가 보내는 이벤트 알림 메시지.
-
-```typescript
-export interface ServiceEventMessage {
-  name: "evt:on";
-  body: {
-    keys: string[];
-    data: unknown;
-  };
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `name` | `"evt:on"` | 고정 문자열 discriminant |
-| `body.keys` | `string[]` | 대상 리스너 키 목록 |
-| `body.data` | `unknown` | 이벤트 데이터 |
-
-## `ServiceProtocol`
-
-바이너리 프로토콜 V2 인코더/디코더 인터페이스. `createServiceProtocol()`로 생성한다.
-
-```typescript
-export interface ServiceProtocol {
-  encode(uuid: string, message: ServiceMessage): { chunks: Bytes[]; totalSize: number };
-  decode<T extends ServiceMessage>(bytes: Bytes): ServiceMessageDecodeResult<T>;
-  dispose(): void;
-}
-```
-
-| Method | Parameters | Return | Description |
-|--------|-----------|--------|-------------|
-| `encode` | `uuid: string, message: ServiceMessage` | `{ chunks: Bytes[]; totalSize: number }` | 메시지를 인코딩한다. 3MB 초과 시 300KB 청크로 자동 분할 |
-| `decode` | `bytes: Bytes` | `ServiceMessageDecodeResult<T>` | 청크를 디코딩한다. 청크가 모두 도착하면 complete, 아니면 progress 반환 |
-| `dispose` | 없음 | `void` | 내부 GC 타이머와 청크 누적기를 해제한다. 사용 후 반드시 호출 |
-
-헤더 구조 (28바이트, Big Endian):
-
-| Offset | Size | Field |
-|--------|------|-------|
-| 0 | 16 | UUID (바이너리) |
-| 16 | 8 | TotalSize (uint64, 상위 4바이트 = 0) |
-| 24 | 4 | Index (uint32) |
-
-## `ServiceMessageDecodeResult`
-
-메시지 디코딩 결과 유니언 타입. `type` 필드로 분기한다.
-
-```typescript
-export type ServiceMessageDecodeResult<TMessage extends ServiceMessage> =
-  | { type: "complete"; uuid: string; message: TMessage }
-  | { type: "progress"; uuid: string; totalSize: number; completedSize: number };
-```
-
-**Variant: `complete`** — 모든 청크가 도착하여 메시지 재조립이 완료된 상태.
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `type` | `"complete"` | discriminant |
-| `uuid` | `string` | 메시지 UUID |
-| `message` | `TMessage` | 재조립된 메시지 |
-
-**Variant: `progress`** — 청크 메시지 수신 진행 중.
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `type` | `"progress"` | discriminant |
-| `uuid` | `string` | 메시지 UUID |
-| `totalSize` | `number` | 전체 크기 (바이트) |
-| `completedSize` | `number` | 수신 완료된 크기 (바이트) |
-
-## `createServiceProtocol`
-
-ServiceProtocol 인스턴스를 생성하는 팩토리 함수.
-
-```typescript
-export function createServiceProtocol(): ServiceProtocol;
-```
-
-내부에 `LazyGcMap` 기반 청크 누적기를 캡슐화한다. 미완성 메시지는 60초 후 GC로 자동 정리된다. 사용 후 반드시 `dispose()`를 호출하여 GC 타이머를 해제해야 한다.

package/claude/references/sd-simplysm14/service-common/docs/service-types.md

@@ -1,90 +0,0 @@
-# Service Types
-
-## `OrmService`
-
-데이터베이스 연결, 트랜잭션 관리, 쿼리 실행을 제공하는 서비스 인터페이스. MySQL, MSSQL, PostgreSQL을 지원한다. 이 패키지에는 구현체가 없으며, 서버(`service-server`)와 클라이언트(`service-client`)가 공유하는 타입 계약이다.
-
-```typescript
-export interface OrmService {
-  getInfo(opt: DbConnOptions & { configName: string }): Promise<{
-    dialect: Dialect;
-    database?: string;
-    schema?: string;
-  }>;
-  connect(opt: DbConnOptions & { configName: string }): Promise<number>;
-  close(connId: number): Promise<void>;
-  beginTransaction(connId: number, isolationLevel?: IsolationLevel): Promise<void>;
-  commitTransaction(connId: number): Promise<void>;
-  rollbackTransaction(connId: number): Promise<void>;
-  executeParametrized(connId: number, query: string, params?: unknown[]): Promise<unknown[][]>;
-  executeDefs(
-    connId: number,
-    defs: QueryDef[],
-    options?: (ResultMeta | undefined)[],
-  ): Promise<unknown[][]>;
-  bulkInsert(
-    connId: number,
-    tableName: string,
-    columnDefs: Record<string, ColumnMeta>,
-    records: Record<string, unknown>[],
-  ): Promise<void>;
-}
-```
-
-| Method | Parameters | Return | Description |
-|--------|-----------|--------|-------------|
-| `getInfo` | `opt: DbConnOptions & { configName: string }` | `Promise<{ dialect, database?, schema? }>` | DB 연결 정보 (dialect, database, schema) 조회 |
-| `connect` | `opt: DbConnOptions & { configName: string }` | `Promise<number>` | DB 연결을 생성하고 연결 ID 반환 |
-| `close` | `connId: number` | `Promise<void>` | 연결 종료 |
-| `beginTransaction` | `connId: number, isolationLevel?: IsolationLevel` | `Promise<void>` | 트랜잭션 시작 |
-| `commitTransaction` | `connId: number` | `Promise<void>` | 트랜잭션 커밋 |
-| `rollbackTransaction` | `connId: number` | `Promise<void>` | 트랜잭션 롤백 |
-| `executeParametrized` | `connId: number, query: string, params?: unknown[]` | `Promise<unknown[][]>` | 파라미터 바인딩 쿼리 실행 |
-| `executeDefs` | `connId: number, defs: QueryDef[], options?: (ResultMeta \| undefined)[]` | `Promise<unknown[][]>` | QueryDef 배열로 쿼리 실행 |
-| `bulkInsert` | `connId: number, tableName: string, columnDefs: Record<string, ColumnMeta>, records: Record<string, unknown>[]` | `Promise<void>` | 대량 삽입 |
-
-사용 순서: `connect()` -> `beginTransaction()` -> `executeDefs()`/`executeParametrized()` -> `commitTransaction()`/`rollbackTransaction()` -> `close()`
-
-## `DbConnOptions`
-
-데이터베이스 연결 옵션.
-
-```typescript
-export type DbConnOptions = { configName?: string; config?: Record<string, unknown> };
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `configName` | `string?` | 서버에 등록된 DB 설정 이름 |
-| `config` | `Record<string, unknown>?` | 직접 지정하는 DB 연결 설정 |
-
-## `AutoUpdateService`
-
-클라이언트 애플리케이션의 최신 버전 정보를 조회하는 서비스 인터페이스.
-
-```typescript
-export interface AutoUpdateService {
-  getLastVersion(platform: string): Promise<
-    | { version: string; downloadPath: string }
-    | undefined
-  >;
-}
-```
-
-| Method | Parameters | Return | Description |
-|--------|-----------|--------|-------------|
-| `getLastVersion` | `platform: string` | `Promise<{ version, downloadPath } \| undefined>` | 지정된 플랫폼(예: "win32", "darwin", "linux")의 최신 버전 정보 조회. 버전이 없으면 undefined |
-
-## `AppStructureService`
-
-서버에 등록된 앱 구조 항목을 클라이언트명 기준 맵으로 조회하는 서비스 인터페이스.
-
-```typescript
-export interface AppStructureService {
-  getItems(): Record<string, AppStructureItem[]>;
-}
-```
-
-| Method | Parameters | Return | Description |
-|--------|-----------|--------|-------------|
-| `getItems` | 없음 | `Record<string, AppStructureItem[]>` | 클라이언트명을 키로, 해당 클라이언트의 앱 구조 항목 배열을 값으로 하는 맵 반환 |

package/claude/references/sd-simplysm14/service-common/docs/types.md

@@ -1,19 +0,0 @@
-# Types
-
-## `ServiceUploadResult`
-
-파일 업로드 결과. 서버에 업로드된 파일의 정보를 포함한다.
-
-```typescript
-export interface ServiceUploadResult {
-  path: string;
-  filename: string;
-  size: number;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `path` | `string` | 서버 내 저장 경로 |
-| `filename` | `string` | 원본 파일명 |
-| `size` | `number` | 파일 크기 (바이트) |

package/claude/references/sd-simplysm14/service-common/usage.md

@@ -1,154 +0,0 @@
-# @simplysm/service-common
-
-서비스 클라이언트와 서버가 공유하는 바이너리 프로토콜, 메시지 타입, 서비스 인터페이스, 앱 구조 정의 패키지.
-
-## Installation
-
-```bash
-npm install @simplysm/service-common
-```
-
-## API Overview
-
-### Protocol
-
-| API | Type | Description |
-|-----|------|-------------|
-| `PROTOCOL_CONFIG` | const | 프로토콜 설정 상수 (최대 크기, 청킹 임계값, 청크 크기, GC 주기, 만료 시간) |
-| `ServiceMessage` | type | 양방향 메시지의 유니언 타입 |
-| `ServiceClientMessage` | type | 클라이언트 → 서버 메시지 유니언 |
-| `ServiceServerMessage` | type | 서버 → 클라이언트 메시지 유니언 |
-| `ServiceServerRawMessage` | type | 진행 상태를 포함한 서버 메시지 유니언 |
-| `ServiceProgressMessage` | interface | 청크 수신 진행 상태 알림 |
-| `ServiceErrorMessage` | interface | 서버 에러 알림 |
-| `ServiceAuthMessage` | interface | 클라이언트 인증 메시지 (토큰) |
-| `ServiceRequestMessage` | interface | 서비스 메서드 요청 |
-| `ServiceResponseMessage` | interface | 서비스 메서드 응답 |
-| `ServiceAddEventListenerMessage` | interface | 이벤트 리스너 추가 요청 |
-| `ServiceRemoveEventListenerMessage` | interface | 이벤트 리스너 제거 요청 |
-| `ServiceGetEventListenerInfosMessage` | interface | 이벤트 리스너 정보 목록 요청 |
-| `ServiceEmitEventMessage` | interface | 이벤트 발생 요청 |
-| `ServiceEventMessage` | interface | 서버 이벤트 알림 |
-| `ServiceProtocol` | interface | 바이너리 프로토콜 인코더/디코더 |
-| `ServiceMessageDecodeResult` | type | 디코딩 결과 유니언 (complete \| progress) |
-| `createServiceProtocol` | function | ServiceProtocol 인스턴스 생성 팩토리 |
-
-→ See [docs/protocol.md](./docs/protocol.md) for details.
-
-### Service Types
-
-| API | Type | Description |
-|-----|------|-------------|
-| `OrmService` | interface | DB 연결, 트랜잭션, 쿼리 실행 서비스 인터페이스 |
-| `DbConnOptions` | type | DB 연결 옵션 타입 |
-| `AutoUpdateService` | interface | 클라이언트 최신 버전 조회 서비스 인터페이스 |
-| `AppStructureService` | interface | 앱 구조 항목 조회 서비스 인터페이스 |
-
-→ See [docs/service-types.md](./docs/service-types.md) for details.
-
-### Types
-
-| API | Type | Description |
-|-----|------|-------------|
-| `ServiceUploadResult` | interface | 파일 업로드 결과 |
-
-→ See [docs/types.md](./docs/types.md) for details.
-
-### App Structure
-
-| API | Type | Description |
-|-----|------|-------------|
-| `AppStructureItem` | type | 앱 구조 항목 (그룹 또는 리프) |
-| `AppStructureGroupItem` | interface | 자식을 가진 그룹 메뉴 항목 |
-| `AppStructureLeafItem` | interface | 말단 메뉴 항목 (권한, URL 포함) |
-| `AppStructureSubPermission` | interface | 리프 항목의 하위 권한 정의 |
-| `FlatPermission` | interface | 플래트닝된 권한 결과 |
-| `isUsableModules` | function | 개별 항목의 모듈 접근 가능 여부 판단 |
-| `isUsableModulesChain` | function | 모듈 체인 전체의 접근 가능 여부 판단 |
-| `getFlatPermissions` | function | 앱 구조 트리를 플래트닝하여 권한 배열 반환 |
-
-→ See [docs/app-structure.md](./docs/app-structure.md) for details.
-
-### Events
-
-| API | Type | Description |
-|-----|------|-------------|
-| `ServiceEventDef` | interface | 타입 안전 이벤트 정의 인터페이스 |
-| `defineEvent` | function | 타입 안전 이벤트를 정의하는 팩토리 함수 |
-
-→ See [docs/events.md](./docs/events.md) for details.
-
-## Usage Examples
-
-### 프로토콜 인코딩/디코딩
-
-```typescript
-import { createServiceProtocol } from "@simplysm/service-common";
-
-const protocol = createServiceProtocol();
-
-// 메시지 인코딩 (3MB 초과 시 자동 청킹)
-const { chunks, totalSize } = protocol.encode(uuid, {
-  name: "OrmService.connect",
-  body: [{ configName: "default" }],
-});
-
-// 메시지 디코딩 (청크 자동 재조립)
-for (const chunk of chunks) {
-  const result = protocol.decode(chunk);
-  if (result.type === "complete") {
-    // result.message: 재조립된 메시지
-  }
-}
-
-// 사용 후 반드시 해제
-protocol.dispose();
-```
-
-### 타입 안전 이벤트 정의
-
-```typescript
-import { defineEvent } from "@simplysm/service-common";
-
-// 서버에서 이벤트 정의 + 타입 export
-export const OrderUpdated = defineEvent<{ orderId: number }, { status: string }>("OrderUpdated");
-
-// 서버에서 이벤트 발생 (제네릭 타입 파라미터 + 문자열 이름 패턴)
-await server.emitEvent<typeof OrderUpdated>("OrderUpdated", (info) => info.orderId === 123, { status: "shipped" });
-
-// 클라이언트에서 구독 (import type으로 타입만 가져옴)
-import type { OrderUpdated } from "@server-package";
-await client.addListener<typeof OrderUpdated>("OrderUpdated", { orderId: 123 }, async (data) => {
-  // data.status는 string으로 타입 추론됨
-});
-```
-
-### 앱 구조 권한 플래트닝
-
-```typescript
-import { getFlatPermissions, isUsableModules } from "@simplysm/service-common";
-import type { AppStructureItem } from "@simplysm/service-common";
-
-const items: AppStructureItem<string>[] = [
-  {
-    code: "admin",
-    title: "관리",
-    children: [
-      { code: "user", title: "사용자", perms: ["use", "edit"] },
-    ],
-  },
-  {
-    code: "report",
-    title: "리포트",
-    modules: ["moduleA"],
-    perms: ["use"],
-  },
-];
-
-// 활성 모듈 기준으로 권한 플래트닝
-const perms = getFlatPermissions(items, ["moduleA"]);
-// [{ codeChain: ["admin", "user", "use"], ... }, { codeChain: ["admin", "user", "edit"], ... }, ...]
-
-// 개별 모듈 접근 가능 여부 확인
-const canAccess = isUsableModules(["moduleA", "moduleB"], undefined, ["moduleA"]); // true (OR 조건)
-```

package/claude/references/sd-simplysm14/service-server/docs/auth.md

@@ -1,64 +0,0 @@
-# Auth
-
-## `AuthTokenPayload`
-
-JWT 페이로드 인터페이스. `jose` 라이브러리의 `JWTPayload`를 확장한다.
-
-```typescript
-interface AuthTokenPayload<TAuthInfo = unknown> extends JWTPayload {
-  roles: string[];
-  data: TAuthInfo;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `roles` | `string[]` | 사용자 역할 배열. `auth(["admin"], ...)` 등에서 역할 검사에 사용된다 |
-| `data` | `TAuthInfo` | 사용자 정의 인증 데이터. `ServiceContext.authInfo`로 접근 가능하다 |
-| (JWTPayload 상속) | — | `iss`, `sub`, `aud`, `exp`, `nbf`, `iat`, `jti` 등 표준 JWT 클레임 |
-
-## `signJwt`
-
-HS256 알고리즘과 12시간 유효기간으로 JWT 토큰을 서명한다.
-
-```typescript
-async function signJwt<TAuthInfo = unknown>(
-  jwtSecret: string,
-  payload: AuthTokenPayload<TAuthInfo>,
-): Promise<string>;
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `jwtSecret` | `string` | HMAC 서명 시크릿 |
-| `payload` | `AuthTokenPayload<TAuthInfo>` | JWT 페이로드 |
-
-반환값: 서명된 JWT 토큰 문자열.
-
-## `verifyJwt`
-
-JWT 토큰을 검증하고 페이로드를 반환한다. 만료된 토큰은 "토큰이 만료되었습니다." 에러를, 그 외 유효하지 않은 토큰은 "유효하지 않은 토큰입니다." 에러를 던진다.
-
-```typescript
-async function verifyJwt<TAuthInfo = unknown>(
-  jwtSecret: string,
-  token: string,
-): Promise<AuthTokenPayload<TAuthInfo>>;
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `jwtSecret` | `string` | HMAC 서명 시크릿 |
-| `token` | `string` | 검증할 JWT 토큰 문자열 |
-
-## `decodeJwt`
-
-JWT 토큰을 검증 없이 디코딩한다. 서명 검증이나 만료 확인을 수행하지 않는다.
-
-```typescript
-function decodeJwt<TAuthInfo = unknown>(token: string): AuthTokenPayload<TAuthInfo>;
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `token` | `string` | 디코딩할 JWT 토큰 문자열 |