@simplysm/service-common 13.0.0-beta.11

package/dist/service-common/src/protocol/protocol.types.d.ts

@@ -0,0 +1,100 @@
+/** 서비스 프로토콜 설정 */
+export declare const PROTOCOL_CONFIG: {
+    /** 최대 메시지 크기 (100MB) */
+    readonly MAX_TOTAL_SIZE: number;
+    /** 청킹 임계값 (3MB) */
+    readonly SPLIT_MESSAGE_SIZE: number;
+    /** 청크 크기 (300KB) */
+    readonly CHUNK_SIZE: number;
+    /** GC 주기 (10초) */
+    readonly GC_INTERVAL: number;
+    /** 미완성 메시지 만료 시간 (60초) */
+    readonly EXPIRE_TIME: number;
+};
+export type ServiceMessage = ServiceReloadMessage | ServiceRequestMessage | ServiceAuthMessage | ServiceProgressMessage | ServiceResponseMessage | ServiceErrorMessage | ServiceAddEventListenerMessage | ServiceRemoveEventListenerMessage | ServiceGetEventListenerInfosMessage | ServiceEmitEventMessage | ServiceEventMessage;
+export type ServiceServerMessage = ServiceReloadMessage | ServiceResponseMessage | ServiceErrorMessage | ServiceEventMessage;
+export type ServiceServerRawMessage = ServiceProgressMessage | ServiceServerMessage;
+export type ServiceClientMessage = ServiceRequestMessage | ServiceAuthMessage | ServiceAddEventListenerMessage | ServiceRemoveEventListenerMessage | ServiceGetEventListenerInfosMessage | ServiceEmitEventMessage;
+/** 서버: 클라이언트에게 reload 명령 */
+export interface ServiceReloadMessage {
+    name: "reload";
+    body: {
+        clientName: string | undefined;
+        changedFileSet: Set<string>;
+    };
+}
+/** 서버: 받은 분할메시지에 대한 progress 알림 */
+export interface ServiceProgressMessage {
+    name: "progress";
+    body: {
+        totalSize: number;
+        completedSize: number;
+    };
+}
+/** 서버: 에러 발생 알림 */
+export interface ServiceErrorMessage {
+    name: "error";
+    body: {
+        name: string;
+        message: string;
+        code: string;
+        stack?: string;
+        detail?: unknown;
+        cause?: unknown;
+    };
+}
+/** 클라: 인증 메시지 */
+export interface ServiceAuthMessage {
+    name: "auth";
+    body: string;
+}
+/** 클라: ServiceMethod 요청 */
+export interface ServiceRequestMessage {
+    name: `${string}.${string}`;
+    body: unknown[];
+}
+/** 서버: ServiceMethod 응답 */
+export interface ServiceResponseMessage {
+    name: "response";
+    body?: unknown;
+}
+/** 클라: 이벤트 리스너 등록 */
+export interface ServiceAddEventListenerMessage {
+    name: "evt:add";
+    body: {
+        key: string;
+        name: string;
+        info: unknown;
+    };
+}
+/** 클라: 이벤트 리스너 제거 */
+export interface ServiceRemoveEventListenerMessage {
+    name: "evt:remove";
+    body: {
+        key: string;
+    };
+}
+/** 클라: 이벤트 리스너 정보 목록 요청 */
+export interface ServiceGetEventListenerInfosMessage {
+    name: "evt:gets";
+    body: {
+        name: string;
+    };
+}
+/** 클라: 이벤트 발생 */
+export interface ServiceEmitEventMessage {
+    name: "evt:emit";
+    body: {
+        keys: string[];
+        data: unknown;
+    };
+}
+/** 서버: 이벤트 발생 알림 */
+export interface ServiceEventMessage {
+    name: "evt:on";
+    body: {
+        keys: string[];
+        data: unknown;
+    };
+}
+//# sourceMappingURL=protocol.types.d.ts.map

package/dist/service-common/src/protocol/protocol.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.types.d.ts","sourceRoot":"","sources":["../../../../src/protocol/protocol.types.ts"],"names":[],"mappings":"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"}

package/dist/service-common/src/protocol/service-protocol.d.ts

@@ -0,0 +1,63 @@
+import type { Bytes } from "@simplysm/core-common";
+import "@simplysm/core-common";
+import { type ServiceMessage } from "./protocol.types";
+/**
+ * 서비스 프로토콜 인코더/디코더
+ *
+ * Binary Protocol V2:
+ * - Header: 28 bytes (UUID 16 + TotalSize 8 + Index 4)
+ * - Body: JSON
+ * - 자동 청킹: 3MB 초과 시 300KB 단위 분할
+ * - 최대 메시지: 100MB
+ */
+export declare class ServiceProtocol {
+    /**
+     * 메시지 인코딩 (필요 시 자동 분할)
+     */
+    encode(uuid: string, message: ServiceMessage): {
+        chunks: Bytes[];
+        totalSize: number;
+    };
+    /**
+     * 메시지 청크 인코딩 (헤더 + 바디)
+     *
+     * 헤더 구조 (28 bytes, Big Endian):
+     * ```
+     * Offset  Size  Field
+     * ------  ----  -----
+     *   0     16    UUID (binary)
+     *  16      8    TotalSize (uint64)
+     *  24      4    Index (uint32)
+     * ```
+     */
+    private _encode;
+    private readonly _accumulator;
+    /**
+     * 프로토콜 인스턴스를 정리한다.
+     *
+     * 내부 청크 누적기의 GC 타이머를 해제하고 메모리를 정리한다.
+     * 프로토콜 인스턴스 사용이 끝나면 반드시 호출해야 한다.
+     */
+    dispose(): void;
+    /**
+     * 메시지 디코딩 (분할 패킷 자동 조립)
+     */
+    decode<T extends ServiceMessage>(bytes: Bytes): ServiceMessageDecodeResult<T>;
+}
+/**
+ * 메시지 디코딩 결과 타입 (유니온)
+ *
+ * - `type: "complete"`: 모든 청크가 수신되어 메시지 조립이 완료됨
+ * - `type: "progress"`: 분할 메시지 수신 중 (일부 청크만 도착)
+ */
+export type ServiceMessageDecodeResult<T extends ServiceMessage> = {
+    type: "complete";
+    uuid: string;
+    message: T;
+} | {
+    type: "progress";
+    uuid: string;
+    totalSize: number;
+    completedSize: number;
+};
+//# sourceMappingURL=service-protocol.d.ts.map

package/dist/service-common/src/protocol/service-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-protocol.d.ts","sourceRoot":"","sources":["../../../../src/protocol/service-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,uBAAuB,CAAC;AAE/B,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAExE;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAK1B;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG;QAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAqCrF;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,OAAO;IA0Bf,OAAO,CAAC,QAAQ,CAAC,YAAY,CAU1B;IAEH;;;;;OAKG;IACH,OAAO,IAAI,IAAI;IAIf;;OAEG;IACH,MAAM,CAAC,CAAC,SAAS,cAAc,EAAE,KAAK,EAAE,KAAK,GAAG,0BAA0B,CAAC,CAAC,CAAC;CAmE9E;AAED;;;;;GAKG;AACH,MAAM,MAAM,0BAA0B,CAAC,CAAC,SAAS,cAAc,IAC3D;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,CAAC,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/service-common/src/service-types/auto-update-service.types.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 자동 업데이트 서비스 인터페이스
+ *
+ * 클라이언트 애플리케이션의 최신 버전 정보를 조회한다.
+ */
+export interface AutoUpdateService {
+    /**
+     * 지정된 플랫폼의 최신 버전 정보를 조회한다.
+     * @param platform 대상 플랫폼 (예: "win32", "darwin", "linux")
+     * @returns 최신 버전 정보. 버전이 없으면 undefined
+     */
+    getLastVersion(platform: string): Promise<{
+        version: string;
+        downloadPath: string;
+    } | undefined>;
+}
+//# sourceMappingURL=auto-update-service.types.d.ts.map

package/dist/service-common/src/service-types/auto-update-service.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-update-service.types.d.ts","sourceRoot":"","sources":["../../../../src/service-types/auto-update-service.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CACrC;QACE,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;KACtB,GACD,SAAS,CACZ,CAAC;CACH"}

package/dist/service-common/src/service-types/crypto-service.types.d.ts

@@ -0,0 +1,22 @@
+import type { Bytes } from "@simplysm/core-common";
+/**
+ * 암호화 서비스 인터페이스
+ *
+ * SHA256 해시 및 AES 대칭키 암호화/복호화 기능을 제공한다.
+ */
+export interface CryptoService {
+    /** SHA256 해시 생성 */
+    encrypt(data: string | Bytes): Promise<string>;
+    /** AES 암호화 */
+    encryptAes(data: Bytes): Promise<string>;
+    /** AES 복호화 */
+    decryptAes(encText: string): Promise<Bytes>;
+}
+/**
+ * 암호화 서비스 설정
+ */
+export interface CryptoConfig {
+    /** AES 암호화 키 */
+    key: string;
+}
+//# sourceMappingURL=crypto-service.types.d.ts.map

package/dist/service-common/src/service-types/crypto-service.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto-service.types.d.ts","sourceRoot":"","sources":["../../../../src/service-types/crypto-service.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,cAAc;IACd,UAAU,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,cAAc;IACd,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gBAAgB;IAChB,GAAG,EAAE,MAAM,CAAC;CACb"}

package/dist/service-common/src/service-types/orm-service.types.d.ts

@@ -0,0 +1,30 @@
+import type { Dialect, IsolationLevel, QueryDef, ColumnMeta, ResultMeta } from "@simplysm/orm-common";
+/**
+ * ORM 서비스 인터페이스
+ *
+ * 데이터베이스 연결, 트랜잭션 관리, 쿼리 실행 기능을 제공한다.
+ * MySQL, MSSQL, PostgreSQL을 지원한다.
+ */
+export interface OrmService {
+    getInfo(opt: DbConnOptions & {
+        configName: string;
+    }): Promise<{
+        dialect: Dialect;
+        database?: string;
+        schema?: string;
+    }>;
+    connect(opt: Record<string, unknown>): 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>;
+}
+/** 데이터베이스 연결 옵션 */
+export type DbConnOptions = {
+    configName?: string;
+    config?: Record<string, unknown>;
+};
+//# sourceMappingURL=orm-service.types.d.ts.map

package/dist/service-common/src/service-types/orm-service.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orm-service.types.d.ts","sourceRoot":"","sources":["../../../../src/service-types/orm-service.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEtG;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAC5D,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvD,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjF,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAE7F,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,UAAU,GAAG,SAAS,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAE1G,UAAU,CACR,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EACtC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACjC,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED,mBAAmB;AACnB,MAAM,MAAM,aAAa,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC"}

package/dist/service-common/src/service-types/smtp-service.types.d.ts

@@ -0,0 +1,55 @@
+import type { Bytes } from "@simplysm/core-common";
+/**
+ * SMTP 서비스 인터페이스
+ *
+ * 이메일 전송 기능을 제공한다.
+ * 직접 SMTP 설정을 전달하거나 서버 설정을 참조하여 전송할 수 있다.
+ */
+export interface SmtpService {
+    /** 직접 SMTP 설정으로 이메일 전송 */
+    send(options: SmtpSendOption): Promise<string>;
+    /** 서버 설정 참조로 이메일 전송 */
+    sendByConfig(configName: string, options: SmtpSendByConfigOption): Promise<string>;
+}
+/**
+ * 이메일 첨부 파일 정보
+ *
+ * content 또는 path 중 하나를 지정해야 한다.
+ */
+export interface SmtpSendAttachment {
+    /** 첨부 파일명 */
+    filename: string;
+    /** 파일 내용 (바이너리) */
+    content?: Bytes;
+    /** 서버 내 파일 경로 */
+    path?: string;
+    /** MIME 타입 (예: "application/pdf") */
+    contentType?: string;
+}
+/** SMTP 연결 옵션 (공통) */
+export interface SmtpConnectionOptions {
+    host: string;
+    port?: number;
+    secure?: boolean;
+    user?: string;
+    pass?: string;
+}
+/** 이메일 내용 옵션 (공통) */
+export interface SmtpEmailContentOptions {
+    to: string;
+    cc?: string;
+    bcc?: string;
+    subject: string;
+    html: string;
+    attachments?: SmtpSendAttachment[];
+}
+export interface SmtpSendByConfigOption extends SmtpEmailContentOptions {
+}
+export interface SmtpSendOption extends SmtpConnectionOptions, SmtpEmailContentOptions {
+    from: string;
+}
+export interface SmtpConfig extends SmtpConnectionOptions {
+    senderName: string;
+    senderEmail?: string;
+}
+//# sourceMappingURL=smtp-service.types.d.ts.map

package/dist/service-common/src/service-types/smtp-service.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smtp-service.types.d.ts","sourceRoot":"","sources":["../../../../src/service-types/smtp-service.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,0BAA0B;IAC1B,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,uBAAuB;IACvB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACpF;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,aAAa;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,sBAAsB;AACtB,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAqB;AACrB,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,sBAAuB,SAAQ,uBAAuB;CAAG;AAE1E,MAAM,WAAW,cAAe,SAAQ,qBAAqB,EAAE,uBAAuB;IACpF,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAW,SAAQ,qBAAqB;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/service-common/src/types.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 이벤트 리스너 타입 정의용 추상 클래스
+ *
+ * - 상속만 하면 됨 (프로퍼티 구현 불필요)
+ * - $info, $data는 타입 추출용 (런타임 미사용)
+ * - eventName은 mangle 안전한 이벤트 식별자
+ *
+ * @example
+ * export class SharedDataChangeEvent extends ServiceEventListener<
+ *   { name: string; filter: unknown },
+ *   (string | number)[] | undefined
+ * > {
+ *   readonly eventName = "SharedDataChangeEvent";
+ * }
+ *
+ * // 클라이언트에서 사용
+ * await client.addEventListener(
+ *   SharedDataChangeEvent,
+ *   { name: "test", filter: null },
+ *   (data) => console.log(data)
+ * );
+ */
+export declare abstract class ServiceEventListener<TInfo, TData> {
+    /** mangle 안전한 이벤트 식별자 (상속 시 필수 구현) */
+    abstract readonly eventName: string;
+    /** 타입 추출용 (런타임 미사용) */
+    readonly $info: TInfo;
+    readonly $data: TData;
+}
+/**
+ * 파일 업로드 결과
+ *
+ * 서버에 업로드된 파일의 정보를 담는다.
+ */
+export interface ServiceUploadResult {
+    /** 서버 내 저장 경로 */
+    path: string;
+    /** 원본 파일명 */
+    filename: string;
+    /** 파일 크기 (bytes) */
+    size: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/service-common/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,8BAAsB,oBAAoB,CAAC,KAAK,EAAE,KAAK;IACrD,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAEpC,uBAAuB;IACvB,SAAiB,KAAK,EAAE,KAAK,CAAC;IAC9B,SAAiB,KAAK,EAAE,KAAK,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/service-types/auto-update-service.types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=auto-update-service.types.js.map

package/dist/service-types/auto-update-service.types.js.map

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

package/dist/service-types/crypto-service.types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=crypto-service.types.js.map

package/dist/service-types/crypto-service.types.js.map

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

package/dist/service-types/orm-service.types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=orm-service.types.js.map

package/dist/service-types/orm-service.types.js.map

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

package/dist/service-types/smtp-service.types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=smtp-service.types.js.map

package/dist/service-types/smtp-service.types.js.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+class ServiceEventListener {
+}
+export {
+  ServiceEventListener
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/types.ts"],
+  "sourcesContent": ["/**\n * \uC774\uBCA4\uD2B8 \uB9AC\uC2A4\uB108 \uD0C0\uC785 \uC815\uC758\uC6A9 \uCD94\uC0C1 \uD074\uB798\uC2A4\n *\n * - \uC0C1\uC18D\uB9CC \uD558\uBA74 \uB428 (\uD504\uB85C\uD37C\uD2F0 \uAD6C\uD604 \uBD88\uD544\uC694)\n * - $info, $data\uB294 \uD0C0\uC785 \uCD94\uCD9C\uC6A9 (\uB7F0\uD0C0\uC784 \uBBF8\uC0AC\uC6A9)\n * - eventName\uC740 mangle \uC548\uC804\uD55C \uC774\uBCA4\uD2B8 \uC2DD\uBCC4\uC790\n *\n * @example\n * export class SharedDataChangeEvent extends ServiceEventListener<\n *   { name: string; filter: unknown },\n *   (string | number)[] | undefined\n * > {\n *   readonly eventName = \"SharedDataChangeEvent\";\n * }\n *\n * // \uD074\uB77C\uC774\uC5B8\uD2B8\uC5D0\uC11C \uC0AC\uC6A9\n * await client.addEventListener(\n *   SharedDataChangeEvent,\n *   { name: \"test\", filter: null },\n *   (data) => console.log(data)\n * );\n */\nexport abstract class ServiceEventListener<TInfo, TData> {\n  /** mangle \uC548\uC804\uD55C \uC774\uBCA4\uD2B8 \uC2DD\uBCC4\uC790 (\uC0C1\uC18D \uC2DC \uD544\uC218 \uAD6C\uD604) */\n  abstract readonly eventName: string;\n\n  /** \uD0C0\uC785 \uCD94\uCD9C\uC6A9 (\uB7F0\uD0C0\uC784 \uBBF8\uC0AC\uC6A9) */\n  declare readonly $info: TInfo;\n  declare readonly $data: TData;\n}\n\n/**\n * \uD30C\uC77C \uC5C5\uB85C\uB4DC \uACB0\uACFC\n *\n * \uC11C\uBC84\uC5D0 \uC5C5\uB85C\uB4DC\uB41C \uD30C\uC77C\uC758 \uC815\uBCF4\uB97C \uB2F4\uB294\uB2E4.\n */\nexport interface ServiceUploadResult {\n  /** \uC11C\uBC84 \uB0B4 \uC800\uC7A5 \uACBD\uB85C */\n  path: string;\n  /** \uC6D0\uBCF8 \uD30C\uC77C\uBA85 */\n  filename: string;\n  /** \uD30C\uC77C \uD06C\uAE30 (bytes) */\n  size: number;\n}\n"],
+  "mappings": "AAsBO,MAAe,qBAAmC;AAOzD;",
+  "names": []
+}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@simplysm/service-common",
+  "sideEffects": false,
+  "version": "13.0.0-beta.11",
+  "description": "심플리즘 패키지 - 서비스 모듈 (common)",
+  "author": "김석래",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kslhunter/simplysm.git",
+    "directory": "packages/service-common"
+  },
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@simplysm/core-common": "13.0.0-beta.11",
+    "@simplysm/orm-common": "13.0.0-beta.11"
+  }
+}