sonamu 0.5.6 → 0.6.0

package/dist/syncer/syncer.d.ts

@@ -1,128 +1,113 @@
-import { EntityNamesRecord } from "../entity/entity-manager";
-import ts from "typescript";
-import { ApiParam, ApiParamType, EntityProp, EntityPropNode } from "../types/types";
-import { ApiDecoratorOptions } from "../api/decorators";
+import { GenerateOptions } from "../types/types";
+import { TemplateKey, TemplateOptions } from "../types/types";
+import { AbsolutePath } from "../utils/path-utils";
+import { LoadedApis, LoadedModels, LoadedTypes } from "./module-loader";
 import { z } from "zod";
-import { TemplateKey, PathAndCode, TemplateOptions, GenerateOptions, RenderingNode } from "../types/types";
-import { Template } from "../templates/base-template";
-type FileType = "model" | "types" | "functions" | "generated" | "entity" | "frame";
-type GlobPattern = {
-    [key in FileType]: string;
-};
-type PathAndChecksum = {
-    path: string;
-    checksum: string;
-};
-export type RenderedTemplate = {
-    target: string;
-    path: string;
-    body: string;
-    importKeys: string[];
-    customHeaders?: string[];
-    preTemplates?: {
-        key: TemplateKey;
-        options: TemplateOptions[TemplateKey];
-    }[];
-};
 export declare class Syncer {
-    apis: {
-        typeParameters: ApiParamType.TypeParam[];
-        parameters: ApiParam[];
-        returnType: ApiParamType;
-        modelName: string;
-        methodName: string;
-        path: string;
-        options: ApiDecoratorOptions;
-    }[];
-    types: {
-        [typeName: string]: z.ZodObject<any>;
-    };
-    models: {
-        [modelName: string]: unknown;
-    };
+    apis: LoadedApis;
+    types: LoadedTypes;
+    models: LoadedModels;
     isSyncing: boolean;
-    checksumPatternGroup: GlobPattern;
-    get checksumsPath(): string;
-    constructor();
+    /**
+     * 체크섬이 변경된 부분에 대해 싱크를 진행합니다.
+     * 다만 sonamu.shared.ts는 체크섬 비교 없이 무조건 싱크(복사)합니다.
+     * @returns
+     */
     sync(): Promise<void>;
-    doSyncActions(diffFiles: string[], currentChecksums?: PathAndChecksum[]): Promise<{
-        diffTypes: string[];
-        changedChecksums?: PathAndChecksum[];
-    }>;
-    syncFromWatcher(diffFiles: string[]): Promise<void>;
-    getEntityIdFromPath(filePaths: string[]): string[];
-    actionGenerateSchemas(): Promise<string[]>;
-    actionGenerateServices(paramsArray: {
-        namesRecord: EntityNamesRecord;
-        modelTsPath: string;
-    }[]): Promise<string[]>;
-    actionGenerateHttps(): Promise<string[]>;
-    copyFileWithReplaceCoreToShared(fromPath: string, toPath: string): Promise<void>;
-    actionSyncFilesToTargets(tsPaths: string[]): Promise<string[]>;
-    getCurrentChecksums(): Promise<PathAndChecksum[]>;
-    getPreviousChecksums(): Promise<PathAndChecksum[]>;
-    saveChecksums(checksums: PathAndChecksum[]): Promise<void>;
-    getChecksumOfFile(filePath: string): Promise<string>;
-    readApisFromFile(filePath: string): Promise<{
-        typeParameters: ApiParamType.TypeParam[];
-        parameters: ApiParam[];
-        returnType: ApiParamType;
-        modelName: string;
-        methodName: string;
-        path: string;
-        options: ApiDecoratorOptions;
-        streamOptions?: import("../api/decorators").StreamDecoratorOptions;
-        uploadOptions?: import("../api/decorators").UploadDecoratorOptions;
-    }[]>;
-    resolveTypeNode(typeNode: ts.TypeNode): ApiParamType;
-    resolveParamDec: (paramDec: {
-        name: ts.BindingName;
-        type: ts.TypeNode;
-        optional?: boolean;
-        defaultDef?: string;
-    }, index?: number) => ApiParam;
-    printNode(node: ts.Node | undefined, sourceFile: ts.SourceFile): string | undefined;
-    autoloadApis(): Promise<{
-        typeParameters: ApiParamType.TypeParam[];
-        parameters: ApiParam[];
-        returnType: ApiParamType;
-        modelName: string;
-        methodName: string;
-        path: string;
-        options: ApiDecoratorOptions;
-    }[]>;
-    autoloadModels(): Promise<{
-        [modelName: string]: unknown;
-    }>;
-    autoloadTypes(doRefresh?: boolean): Promise<{
-        [typeName: string]: z.ZodObject<any>;
-    }>;
-    getTemplate(key: TemplateKey): Template;
-    renderTemplate<T extends keyof TemplateOptions>(key: T, options: TemplateOptions[T]): Promise<PathAndCode[]>;
-    resolveRenderedTemplate(key: TemplateKey, result: RenderedTemplate): Promise<PathAndCode>;
-    writeCodeToPath(pathAndCode: PathAndCode): Promise<string[]>;
-    generateTemplate(key: TemplateKey, templateOptions: any, _generateOptions?: GenerateOptions): Promise<string[][]>;
+    /**
+     * Watcher가 감지한 파일 변경 사항에 대해 싱크를 진행합니다.
+     * 주어진 변경 파일들 중 체크섬 관리 대상인 것들만 가져다가 싱크를 진행합니다.
+     * 체크섬 파일 업데이트는 여기에서 하지 않습니다. 호출자가 합니다.
+     * @param diffFilePath - 변경 파일들. 프로젝트 루트부터 "src/" 또는 "dist/"로 시작하는 상대 경로입니다. 예시: "src/application/user/user.model.ts"
+     */
+    syncFromWatcher(event: string, diffFilePath: AbsolutePath): Promise<void>;
+    private copySharedToTargets;
+    autoloadTypes(): Promise<void>;
+    autoloadModels(): Promise<void>;
+    autoloadApis(): Promise<void>;
+    /**
+     * 실제 싱크를 수행하는 본체입니다.
+     * 변경된 파일들을 타입별로 분류하고 각 타입에 맞는 액션을 실행합니다.
+     * @param diffFilePaths - 변경된 파일들의 절대 경로 목록
+     * @returns diffTypes - 변경된 파일의 타입 목록 (entity, types, model 등)
+     */
+    private doSyncActions;
+    private calculateDiffGroups;
+    private handleEntityChange;
+    private handleTypesOrFunctionsOrGeneratedChange;
+    private handleModelOrFrameChange;
+    actionSyncConfig(): Promise<void>;
+    /**
+     * sonamu.generated.ts와 sonamu.generated.sso.ts를 생성합니다.
+     * @returns 생성된 파일 경로 배열.
+     */
+    private actionGenerateSchemas;
+    /**
+     * *.service.ts를 생성합니다.
+     * @param paramsArray
+     * @returns 생성된 파일 경로 배열.
+     */
+    private actionGenerateServices;
+    /**
+     * sonamu.generated.http를 생성합니다.
+     * @returns 생성된 파일 경로.
+     */
+    private actionGenerateHttps;
+    /**
+     * *.types.ts, *.functions.ts, *.generated.ts를 타겟 디렉토리에 복사합니다.
+     * @param tsPaths
+     * @returns 복사된 파일 경로 배열.
+     */
+    private actionSyncFilesToTargets;
+    private copyFileWithReplaceCoreToShared;
+    /**
+     * 주어진 엔티티와 템플릿 키에 대해, 생성된 코드가 존재하는지 확인합니다.
+     * @param entityId 엔티티 ID
+     * @param templateKey 템플릿 키
+     * @param enumId 열거형 ID
+     * @returns 생성된 코드가 존재하는지 여부
+     */
     checkExistsGenCode(entityId: string, templateKey: TemplateKey, enumId?: string): Promise<{
         subPath: string;
         fullPath: string;
         isExists: boolean;
     }>;
+    /**
+     * 주어진 엔티티와 열거형에 대해, 생성된 코드가 존재하는지 확인합니다.
+     * @param entityId 엔티티 ID
+     * @param enums 열거형 레이블
+     * @returns 생성된 코드가 존재하는지 여부
+     */
     checkExists(entityId: string, enums: {
         [name: string]: z.ZodEnum<any>;
     }): Promise<Record<`${TemplateKey}${string}`, boolean>>;
-    getZodTypeById(zodTypeId: string): Promise<z.ZodTypeAny>;
-    propNodeToZodType(propNode: EntityPropNode): Promise<z.ZodTypeAny>;
-    propToZodType(prop: EntityProp): Promise<z.ZodTypeAny>;
-    resolveRenderType(key: string, zodType: z.ZodTypeAny): RenderingNode["renderType"];
-    zodTypeToRenderingNode(zodType: z.ZodType<any>, baseKey?: string): RenderingNode;
-    getColumnsNode(entityId: string, subsetKey: string): Promise<RenderingNode>;
+    syncUI(): void;
+    /**
+     * 하위호환용 프록시 메소드입니다.
+     */
     createEntity(form: Omit<TemplateOptions["entity"], "title"> & {
         title?: string;
     }): Promise<void>;
+    /**
+     * 하위호환용 프록시 메소드입니다.
+     */
     delEntity(entityId: string): Promise<{
         delPaths: string[];
     }>;
-    syncUI(): void;
+    /**
+     * 하위호환용 프록시 메소드입니다.
+     */
+    generateTemplate(key: TemplateKey, templateOptions: any, _generateOptions?: GenerateOptions): Promise<`/${string}`[]>;
+    /**
+     * 하위호환용 프록시 메소드입니다.
+     */
+    renderTemplate(key: TemplateKey, templateOptions: any): Promise<{
+        path: string;
+        code: string;
+    }[]>;
+    /**
+     * 하위호환용 프록시 메소드입니다.
+     */
+    renewChecksums(): Promise<void>;
 }
-export {};
 //# sourceMappingURL=syncer.d.ts.map

package/dist/syncer/syncer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"syncer.d.ts","sourceRoot":"","sources":["../../src/syncer/syncer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"syncer.d.ts","sourceRoot":"","sources":["../../src/syncer/syncer.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAO9D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAYnD,OAAO,EAIL,UAAU,EACV,YAAY,EACZ,WAAW,EACZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,qBAAa,MAAM;IACjB,IAAI,EAAE,UAAU,CAAM;IACtB,KAAK,EAAE,WAAW,CAAM;IACxB,MAAM,EAAE,YAAY,CAAM;IAC1B,SAAS,EAAE,OAAO,CAAS;IAE3B;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B3B;;;;;OAKG;IACG,eAAe,CACnB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,IAAI,CAAC;YAmCF,mBAAmB;IAiC3B,aAAa;IAIb,cAAc;IAId,YAAY;IAIlB;;;;;OAKG;YACW,aAAa;IAqC3B,OAAO,CAAC,mBAAmB;YASb,kBAAkB;YA0ClB,uCAAuC;YAoBvC,wBAAwB;IA6ChC,gBAAgB;IActB;;;OAGG;YACW,qBAAqB;IAWnC;;;;OAIG;YACW,sBAAsB;IAkBpC;;;OAGG;YACW,mBAAmB;IAUjC;;;;OAIG;YACW,wBAAwB;YA+BxB,+BAA+B;IAyB7C;;;;;;OAMG;IACG,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,WAAW,EACxB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IAcpE;;;;;OAKG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE;QACL,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;KAChC,GACA,OAAO,CAAC,MAAM,CAAC,GAAG,WAAW,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IA0CtD,MAAM;IAUN;;OAEG;IACG,YAAY,CAChB,IAAI,EAAE,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAKrE;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAIlE;;OAEG;IACG,gBAAgB,CACpB,GAAG,EAAE,WAAW,EAChB,eAAe,EAAE,GAAG,EACpB,gBAAgB,CAAC,EAAE,eAAe;IAKpC;;OAEG;IACG,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,eAAe,EAAE,GAAG;;;;IAI3D;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;CAGtC"}