swagshot 0.1.0

package/dist/lib/types.d.ts

@@ -0,0 +1,101 @@
+export interface SwagShotConfig {
+    version: string;
+    project: {
+        root: string;
+        apiDir: string;
+        typesDir: string;
+        hooksDir: string | null;
+        outputDir: string;
+    };
+    style: {
+        httpClient: "axios" | "fetch";
+        axiosInstance: string | null;
+        queryLibrary: "react-query" | "swr" | null;
+        namingConvention: "camelCase" | "snake_case";
+    };
+    swagger?: {
+        url: string | null;
+    };
+}
+export interface DetectedStructure {
+    apiDir: string | null;
+    typesDir: string | null;
+    hooksDir: string | null;
+    httpClient: "axios" | "fetch" | null;
+    queryLibrary: "react-query" | "swr" | null;
+    axiosInstance: string | null;
+}
+export interface SwaggerSpec {
+    openapi?: string;
+    swagger?: string;
+    info: {
+        title: string;
+        version: string;
+    };
+    paths: Record<string, PathItem>;
+    components?: {
+        schemas?: Record<string, SchemaObject>;
+    };
+    definitions?: Record<string, SchemaObject>;
+    tags?: Array<{
+        name: string;
+        description?: string;
+    }>;
+}
+export interface PathItem {
+    get?: Operation;
+    post?: Operation;
+    put?: Operation;
+    patch?: Operation;
+    delete?: Operation;
+}
+export interface Operation {
+    tags?: string[];
+    operationId?: string;
+    summary?: string;
+    deprecated?: boolean;
+    parameters?: Parameter[];
+    requestBody?: RequestBody;
+    responses: Record<string, Response>;
+}
+export interface Parameter {
+    name: string;
+    in: "query" | "path" | "header" | "cookie" | "body" | "formData";
+    required?: boolean;
+    description?: string;
+    schema?: SchemaObject;
+    type?: string;
+    format?: string;
+    items?: SchemaObject;
+    enum?: unknown[];
+    collectionFormat?: string;
+}
+export interface RequestBody {
+    required?: boolean;
+    content?: Record<string, {
+        schema?: SchemaObject;
+    }>;
+}
+export interface Response {
+    description?: string;
+    schema?: SchemaObject;
+    content?: Record<string, {
+        schema?: SchemaObject;
+    }>;
+}
+export interface SchemaObject {
+    type?: string;
+    format?: string;
+    $ref?: string;
+    items?: SchemaObject;
+    properties?: Record<string, SchemaObject>;
+    required?: string[];
+    enum?: unknown[];
+    description?: string;
+    nullable?: boolean;
+    allOf?: SchemaObject[];
+    oneOf?: SchemaObject[];
+    anyOf?: SchemaObject[];
+    additionalProperties?: boolean | SchemaObject;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

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

package/dist/lib/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":""}

package/dist/tools/configUpdate.d.ts

@@ -0,0 +1,2 @@
+export declare function handleConfigUpdate(updates: Record<string, string | null>): Promise<string>;
+//# sourceMappingURL=configUpdate.d.ts.map

package/dist/tools/configUpdate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configUpdate.d.ts","sourceRoot":"","sources":["../../src/tools/configUpdate.ts"],"names":[],"mappings":"AAEA,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBhG"}

package/dist/tools/configUpdate.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleConfigUpdate = handleConfigUpdate;
+const configManager_js_1 = require("../lib/configManager.js");
+async function handleConfigUpdate(updates) {
+    const root = process.cwd();
+    try {
+        const config = await (0, configManager_js_1.updateConfig)(root, updates);
+        return [
+            "✅ 설정 업데이트 완료:",
+            "```json",
+            JSON.stringify(updates, null, 2),
+            "```",
+            "",
+            "현재 설정:",
+            "```json",
+            JSON.stringify(config, null, 2),
+            "```",
+        ].join("\n");
+    }
+    catch (e) {
+        return `❌ 설정 업데이트 실패: ${e instanceof Error ? e.message : String(e)}`;
+    }
+}
+//# sourceMappingURL=configUpdate.js.map

package/dist/tools/configUpdate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configUpdate.js","sourceRoot":"","sources":["../../src/tools/configUpdate.ts"],"names":[],"mappings":";;AAEA,gDAmBC;AArBD,8DAAuD;AAEhD,KAAK,UAAU,kBAAkB,CAAC,OAAsC;IAC7E,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAE3B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAA,+BAAY,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACjD,OAAO;YACL,eAAe;YACf,SAAS;YACT,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAChC,KAAK;YACL,EAAE;YACF,QAAQ;YACR,SAAS;YACT,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/B,KAAK;SACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,iBAAiB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,CAAC;AACH,CAAC"}

package/dist/tools/setup.d.ts

@@ -0,0 +1,2 @@
+export declare function handleSetup(projectRoot?: string): Promise<string>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/tools/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/tools/setup.ts"],"names":[],"mappings":"AAKA,wBAAsB,WAAW,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA0DvE"}

package/dist/tools/setup.js

@@ -0,0 +1,63 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleSetup = handleSetup;
+const path_1 = __importDefault(require("path"));
+const configManager_js_1 = require("../lib/configManager.js");
+const detectStructure_js_1 = require("../lib/detectStructure.js");
+async function handleSetup(projectRoot) {
+    const root = projectRoot ?? process.cwd();
+    const existing = await (0, configManager_js_1.readConfig)(root);
+    if (existing) {
+        return [
+            "✅ 이미 설정이 있습니다:",
+            "```json",
+            JSON.stringify(existing, null, 2),
+            "```",
+            "",
+            "변경하려면 `swagger_config_update` 툴을 사용하거나,",
+            "수정할 항목을 알려주세요. 예) 'apiDir를 src/services로 바꿔줘'",
+        ].join("\n");
+    }
+    const detected = await (0, detectStructure_js_1.detectProjectStructure)(root);
+    const config = {
+        version: "1",
+        project: {
+            root,
+            apiDir: detected.apiDir ?? "src/api",
+            typesDir: detected.typesDir ?? "src/types",
+            hooksDir: detected.hooksDir,
+            outputDir: detected.apiDir ?? "src/api",
+        },
+        style: {
+            httpClient: detected.httpClient ?? "axios",
+            axiosInstance: detected.axiosInstance,
+            queryLibrary: detected.queryLibrary,
+            namingConvention: "camelCase",
+        },
+    };
+    await (0, configManager_js_1.writeConfig)(root, config);
+    const lines = [
+        "👋 swagshot 초기 설정 완료!",
+        "",
+        `📂 프로젝트 루트: ${root}`,
+        `📁 설정 파일: ${path_1.default.join(root, configManager_js_1.CONFIG_FILE)}`,
+        "",
+        "감지된 설정:",
+        `  • API 함수 폴더:   ${config.project.apiDir}${detected.apiDir ? " ✅ 자동 감지" : " ⚠️ 기본값 (수정 가능)"}`,
+        `  • 타입 정의 폴더:  ${config.project.typesDir}${detected.typesDir ? " ✅ 자동 감지" : " ⚠️ 기본값 (수정 가능)"}`,
+        `  • 훅 폴더:         ${config.project.hooksDir ?? "없음"}${detected.hooksDir ? " ✅ 자동 감지" : ""}`,
+        `  • HTTP 클라이언트: ${config.style.httpClient}${detected.httpClient ? " ✅ 자동 감지" : " ⚠️ 기본값"}`,
+        `  • Query 라이브러리: ${config.style.queryLibrary ?? "없음"}${detected.queryLibrary ? " ✅ 자동 감지" : ""}`,
+        detected.axiosInstance ? `  • Axios 인스턴스:  ${config.style.axiosInstance} ✅ 자동 감지` : "",
+        "",
+        "잘못된 항목이 있으면 알려주세요.",
+        "예) 'typesDir는 src/types/api야'",
+        "",
+        "이제 `swagger_sync` 툴로 코드를 생성할 수 있습니다!",
+    ].filter((l) => l !== undefined);
+    return lines.join("\n");
+}
+//# sourceMappingURL=setup.js.map

package/dist/tools/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/tools/setup.ts"],"names":[],"mappings":";;;;;AAKA,kCA0DC;AA/DD,gDAAwB;AAExB,8DAA+E;AAC/E,kEAAmE;AAE5D,KAAK,UAAU,WAAW,CAAC,WAAoB;IACpD,MAAM,IAAI,GAAG,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1C,MAAM,QAAQ,GAAG,MAAM,IAAA,6BAAU,EAAC,IAAI,CAAC,CAAC;IAExC,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO;YACL,gBAAgB;YAChB,SAAS;YACT,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YACjC,KAAK;YACL,EAAE;YACF,yCAAyC;YACzC,+CAA+C;SAChD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,IAAA,2CAAsB,EAAC,IAAI,CAAC,CAAC;IAEpD,MAAM,MAAM,GAAmB;QAC7B,OAAO,EAAE,GAAG;QACZ,OAAO,EAAE;YACP,IAAI;YACJ,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,SAAS;YACpC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,WAAW;YAC1C,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,SAAS,EAAE,QAAQ,CAAC,MAAM,IAAI,SAAS;SACxC;QACD,KAAK,EAAE;YACL,UAAU,EAAE,QAAQ,CAAC,UAAU,IAAI,OAAO;YAC1C,aAAa,EAAE,QAAQ,CAAC,aAAa;YACrC,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,gBAAgB,EAAE,WAAW;SAC9B;KACF,CAAC;IAEF,MAAM,IAAA,8BAAW,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAEhC,MAAM,KAAK,GAAG;QACZ,uBAAuB;QACvB,EAAE;QACF,eAAe,IAAI,EAAE;QACrB,aAAa,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,8BAAW,CAAC,EAAE;QAC3C,EAAE;QACF,SAAS;QACT,oBAAoB,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAiB,EAAE;QAC9F,kBAAkB,MAAM,CAAC,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAiB,EAAE;QAChG,qBAAqB,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE;QAC5F,mBAAmB,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,EAAE;QAC3F,oBAAoB,MAAM,CAAC,KAAK,CAAC,YAAY,IAAI,IAAI,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE;QACjG,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,oBAAoB,MAAM,CAAC,KAAK,CAAC,aAAa,UAAU,CAAC,CAAC,CAAC,EAAE;QACtF,EAAE;QACF,oBAAoB;QACpB,+BAA+B;QAC/B,EAAE;QACF,sCAAsC;KACvC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IAEjC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/tools/sync.d.ts

@@ -0,0 +1,2 @@
+export declare function handleSync(swaggerUrl: string, tag?: string, includeDeprecated?: boolean): Promise<string>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/tools/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/tools/sync.ts"],"names":[],"mappings":"AAMA,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,iBAAiB,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAsF7G"}

package/dist/tools/sync.js

@@ -0,0 +1,87 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleSync = handleSync;
+const path_1 = __importDefault(require("path"));
+const promises_1 = __importDefault(require("fs/promises"));
+const configManager_js_1 = require("../lib/configManager.js");
+const fetchSwagger_js_1 = require("../lib/fetchSwagger.js");
+const codeGenerator_js_1 = require("../lib/codeGenerator.js");
+async function handleSync(swaggerUrl, tag, includeDeprecated = false) {
+    const root = process.cwd();
+    const config = await (0, configManager_js_1.readConfig)(root);
+    if (!config) {
+        return [
+            "⚠️ 프로젝트 설정이 없습니다.",
+            "먼저 `swagger_setup` 툴을 실행해주세요.",
+        ].join("\n");
+    }
+    let spec;
+    try {
+        spec = await (0, fetchSwagger_js_1.fetchSwaggerSpec)(swaggerUrl);
+    }
+    catch (e) {
+        return `❌ Swagger 스펙을 가져오는 데 실패했습니다.\n${e instanceof Error ? e.message : String(e)}`;
+    }
+    // If no tag specified, list available tags
+    if (!tag) {
+        const tags = (0, fetchSwagger_js_1.getControllerTags)(spec);
+        if (tags.length === 0) {
+            return "❌ Swagger 스펙에 태그가 없습니다.";
+        }
+        if (tags.length === 1) {
+            tag = tags[0];
+        }
+        else {
+            return [
+                "📋 사용 가능한 컨트롤러 태그:",
+                ...tags.map((t, i) => `  ${i + 1}. ${t}`),
+                "",
+                "어떤 컨트롤러를 생성할까요?",
+                "예) 'payment-controller 생성해줘'",
+                "",
+                "전체 생성하려면: 'all'",
+            ].join("\n");
+        }
+    }
+    // Handle 'all' tag
+    const tagsToProcess = tag === "all" ? (0, fetchSwagger_js_1.getControllerTags)(spec) : [tag];
+    const writtenFiles = [];
+    for (const currentTag of tagsToProcess) {
+        const filteredSpec = (0, fetchSwagger_js_1.filterByTag)(spec, currentTag, includeDeprecated);
+        const endpointCount = Object.values(filteredSpec.paths).reduce((acc, item) => acc + Object.keys(item).length, 0);
+        if (endpointCount === 0) {
+            continue;
+        }
+        // Derive file name from tag
+        const baseName = currentTag.replace(/-controller$/, "").replace(/-/g, "-");
+        // Generate types
+        const typesContent = (0, codeGenerator_js_1.generateTypes)(filteredSpec, currentTag);
+        const typesDir = path_1.default.join(root, config.project.typesDir);
+        await promises_1.default.mkdir(typesDir, { recursive: true });
+        const typesFile = path_1.default.join(typesDir, `${baseName}.ts`);
+        await promises_1.default.writeFile(typesFile, typesContent, "utf-8");
+        writtenFiles.push(typesFile);
+        // Generate API file
+        const apiContent = (0, codeGenerator_js_1.generateApiFile)(filteredSpec, currentTag, config);
+        const apiDir = path_1.default.join(root, config.project.outputDir);
+        await promises_1.default.mkdir(apiDir, { recursive: true });
+        const apiFile = path_1.default.join(apiDir, `${baseName}.ts`);
+        await promises_1.default.writeFile(apiFile, apiContent, "utf-8");
+        writtenFiles.push(apiFile);
+    }
+    if (writtenFiles.length === 0) {
+        return `⚠️ 태그 '${tag}'에 해당하는 엔드포인트를 찾을 수 없습니다.`;
+    }
+    return [
+        `✅ 코드 생성 완료!`,
+        `📌 처리된 태그: ${tagsToProcess.join(", ")}`,
+        `📁 생성된 파일 (${writtenFiles.length}개):`,
+        ...writtenFiles.map((f) => `  - ${path_1.default.relative(root, f)}`),
+        "",
+        "생성된 코드를 확인하고 필요한 경우 수정해주세요.",
+    ].join("\n");
+}
+//# sourceMappingURL=sync.js.map

package/dist/tools/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/tools/sync.ts"],"names":[],"mappings":";;;;;AAMA,gCAsFC;AA5FD,gDAAwB;AACxB,2DAA6B;AAC7B,8DAAqD;AACrD,4DAA0F;AAC1F,8DAAyE;AAElE,KAAK,UAAU,UAAU,CAAC,UAAkB,EAAE,GAAY,EAAE,iBAAiB,GAAG,KAAK;IAC1F,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,MAAM,IAAA,6BAAU,EAAC,IAAI,CAAC,CAAC;IAEtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,mBAAmB;YACnB,+BAA+B;SAChC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,IAAI,IAAI,CAAC;IACT,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,IAAA,kCAAgB,EAAC,UAAU,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,iCAAiC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACvF,CAAC;IAED,2CAA2C;IAC3C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,GAAG,IAAA,mCAAiB,EAAC,IAAI,CAAC,CAAC;QACrC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,yBAAyB,CAAC;QACnC,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,OAAO;gBACL,oBAAoB;gBACpB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzC,EAAE;gBACF,iBAAiB;gBACjB,8BAA8B;gBAC9B,EAAE;gBACF,iBAAiB;aAClB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,MAAM,aAAa,GAAG,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,IAAA,mCAAiB,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACtE,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,KAAK,MAAM,UAAU,IAAI,aAAa,EAAE,CAAC;QACvC,MAAM,YAAY,GAAG,IAAA,6BAAW,EAAC,IAAI,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC;QACtE,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,MAAM,CAC5D,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,EAC7C,CAAC,CACF,CAAC;QAEF,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QAED,4BAA4B;QAC5B,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAE3E,iBAAiB;QACjB,MAAM,YAAY,GAAG,IAAA,gCAAa,EAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAC7D,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC1D,MAAM,kBAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,MAAM,SAAS,GAAG,cAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,QAAQ,KAAK,CAAC,CAAC;QACxD,MAAM,kBAAE,CAAC,SAAS,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;QACrD,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAE7B,oBAAoB;QACpB,MAAM,UAAU,GAAG,IAAA,kCAAe,EAAC,YAAY,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACzD,MAAM,kBAAE,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,QAAQ,KAAK,CAAC,CAAC;QACpD,MAAM,kBAAE,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QACjD,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,UAAU,GAAG,2BAA2B,CAAC;IAClD,CAAC;IAED,OAAO;QACL,aAAa;QACb,cAAc,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACxC,cAAc,YAAY,CAAC,MAAM,KAAK;QACtC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,cAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QAC3D,EAAE;QACF,6BAA6B;KAC9B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "swagshot",
+  "version": "0.1.0",
+  "description": "Swagger-powered API & type generator",
+  "main": "dist/cli/index.js",
+  "bin": {
+    "swagshot": "dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/cli/index.ts",
+    "start": "node dist/cli/index.js",
+    "prepare": "npm run build"
+  },
+  "dependencies": {
+    "axios": "^1.6.0",
+    "commander": "^12.0.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "ts-node": "^10.9.0",
+    "typescript": "^5.3.0"
+  },
+  "files": [
+    "dist/",
+    "src/"
+  ],
+  "keywords": ["swagger", "openapi", "codegen", "typescript", "cli"],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Jyophie/swagshot.git"
+  },
+  "homepage": "https://github.com/Jyophie/swagshot"
+}

package/src/cli/commands/config.ts

@@ -0,0 +1,33 @@
+import { readConfig, writeConfig } from "../../lib/configManager";
+
+export async function configCommand(action: string, key: string, value: string) {
+  if (action !== "set") {
+    console.error(`❌ 알 수 없는 액션: ${action}. 사용 가능: set`);
+    process.exit(1);
+  }
+
+  const root = process.cwd();
+  const config = await readConfig(root);
+
+  if (!config) {
+    console.error("❌ 설정 파일이 없습니다. 먼저 실행하세요: swagshot init");
+    process.exit(1);
+  }
+
+  const parsedValue = value === "null" ? null : value;
+
+  if (key in config.project) {
+    (config.project as Record<string, unknown>)[key] = parsedValue;
+  } else if (key in config.style) {
+    (config.style as Record<string, unknown>)[key] = parsedValue;
+  } else if (key === "swaggerUrl" || key === "url") {
+    config.swagger = { ...config.swagger, url: parsedValue };
+  } else {
+    console.error(`❌ 알 수 없는 설정 키: ${key}`);
+    console.log("사용 가능한 키: apiDir, typesDir, hooksDir, outputDir, httpClient, axiosInstance, queryLibrary, swaggerUrl");
+    process.exit(1);
+  }
+
+  await writeConfig(root, config);
+  console.log(`✅ ${key} = ${value}`);
+}

package/src/cli/commands/generate.ts

@@ -0,0 +1,90 @@
+import path from "path";
+import fs from "fs/promises";
+import { readConfig } from "../../lib/configManager";
+import { fetchSwaggerSpec, filterByTag, getControllerTags } from "../../lib/fetchSwagger";
+import { generateTypes, generateApiFile } from "../../lib/codeGenerator";
+
+interface GenerateOptions {
+  url: string;
+  tag?: string;
+  all?: boolean;
+  includeDeprecated?: boolean;
+}
+
+export async function generateCommand(options: GenerateOptions) {
+  const root = process.cwd();
+  const config = await readConfig(root);
+
+  if (!config) {
+    console.error("❌ 설정 파일이 없습니다. 먼저 실행하세요: swagshot init");
+    process.exit(1);
+  }
+
+  console.log(`\n📡 Swagger 스펙 가져오는 중... ${options.url}`);
+
+  let spec;
+  try {
+    spec = await fetchSwaggerSpec(options.url);
+  } catch (e) {
+    console.error(`❌ Swagger 스펙을 가져오지 못했습니다.\n${e instanceof Error ? e.message : String(e)}`);
+    process.exit(1);
+  }
+
+  const allTags = getControllerTags(spec);
+
+  // 태그 미지정 시 목록 출력 후 종료
+  if (!options.tag && !options.all) {
+    console.log("\n📋 사용 가능한 컨트롤러 태그:");
+    allTags.forEach((t, i) => console.log(`  ${i + 1}. ${t}`));
+    console.log("\n사용법:");
+    console.log(`  swagshot generate --url "${options.url}" --tag <태그명>`);
+    console.log(`  swagshot generate --url "${options.url}" --all`);
+    return;
+  }
+
+  const tagsToProcess = options.all ? allTags : [options.tag!];
+  const writtenFiles: string[] = [];
+
+  for (const tag of tagsToProcess) {
+    if (!allTags.includes(tag)) {
+      console.error(`❌ 태그를 찾을 수 없습니다: "${tag}"`);
+      console.log("사용 가능한 태그:", allTags.join(", "));
+      process.exit(1);
+    }
+
+    const filteredSpec = filterByTag(spec, tag, options.includeDeprecated ?? false);
+    const endpointCount = Object.values(filteredSpec.paths).reduce(
+      (acc, item) => acc + Object.keys(item).length, 0
+    );
+
+    if (endpointCount === 0) continue;
+
+    const baseName = tag.replace(/-controller$/, "");
+
+    // types 파일 생성
+    const typesContent = generateTypes(filteredSpec, tag);
+    const typesDir = path.join(root, config.project.typesDir);
+    await fs.mkdir(typesDir, { recursive: true });
+    const typesFile = path.join(typesDir, `${baseName}.ts`);
+    await fs.writeFile(typesFile, typesContent, "utf-8");
+    writtenFiles.push(typesFile);
+
+    // api 파일 생성
+    const apiContent = generateApiFile(filteredSpec, tag, config);
+    const apiDir = path.join(root, config.project.outputDir);
+    await fs.mkdir(apiDir, { recursive: true });
+    const apiFile = path.join(apiDir, `${baseName}.ts`);
+    await fs.writeFile(apiFile, apiContent, "utf-8");
+    writtenFiles.push(apiFile);
+
+    console.log(`\n✅ ${tag} (${endpointCount}개 엔드포인트)`);
+  }
+
+  if (writtenFiles.length === 0) {
+    console.log("⚠️  생성된 파일이 없습니다.");
+    return;
+  }
+
+  console.log(`\n📁 생성된 파일 (${writtenFiles.length}개):`);
+  writtenFiles.forEach(f => console.log(`  - ${path.relative(root, f)}`));
+}

package/src/cli/commands/init.ts

@@ -0,0 +1,76 @@
+import path from "path";
+import * as readline from "readline/promises";
+import { stdin as input, stdout as output } from "process";
+import { SwagShotConfig } from "../../lib/types";
+import { readConfig, writeConfig, CONFIG_FILE } from "../../lib/configManager";
+import { detectProjectStructure } from "../../lib/detectStructure";
+
+export async function initCommand(options: { root?: string }) {
+  const root = path.resolve(options.root ?? process.cwd());
+  const existing = await readConfig(root);
+
+  if (existing) {
+    console.log("\n✅ 이미 설정 파일이 있습니다:");
+    console.log(JSON.stringify(existing, null, 2));
+    console.log("\n변경하려면: swagshot config set <key> <value>");
+    return;
+  }
+
+  console.log("\n👋 swagshot 초기 설정을 시작합니다.");
+  console.log(`📂 프로젝트 루트: ${root}\n`);
+
+  const detected = await detectProjectStructure(root);
+
+  const rl = readline.createInterface({ input, output });
+
+  async function ask(question: string, defaultValue: string): Promise<string> {
+    const answer = await rl.question(`${question} (기본값: ${defaultValue}): `);
+    return answer.trim() || defaultValue;
+  }
+
+  console.log("자동 감지 결과를 확인해주세요. Enter를 누르면 기본값 사용:\n");
+
+  const swaggerUrl = await ask("Swagger JSON URL", "");
+  const apiDir = await ask("API 함수 폴더", detected.apiDir ?? "src/api");
+  const typesDir = await ask("타입 정의 폴더", detected.typesDir ?? "src/types");
+  const hooksDir = await ask("훅 폴더 (없으면 빈칸)", detected.hooksDir ?? "");
+  const httpClient = await ask("HTTP 클라이언트 (axios/fetch)", detected.httpClient ?? "axios");
+  const axiosInstance = httpClient === "axios"
+    ? await ask("axios 인스턴스 파일 경로 (없으면 빈칸)", detected.axiosInstance ?? "")
+    : "";
+  const queryLibrary = await ask("Query 라이브러리 (react-query/swr/없으면 빈칸)", detected.queryLibrary ?? "");
+
+  rl.close();
+
+  const config: SwagShotConfig = {
+    version: "1",
+    project: {
+      root,
+      apiDir,
+      typesDir,
+      hooksDir: hooksDir || null,
+      outputDir: apiDir,
+    },
+    style: {
+      httpClient: httpClient as "axios" | "fetch",
+      axiosInstance: axiosInstance || null,
+      queryLibrary: (queryLibrary || null) as "react-query" | "swr" | null,
+      namingConvention: "camelCase",
+    },
+    swagger: {
+      url: swaggerUrl || null,
+    },
+  };
+
+  await writeConfig(root, config);
+
+  console.log(`\n✅ 설정 완료! ${path.join(root, CONFIG_FILE)} 저장됨`);
+  console.log("\n이제 코드를 생성할 수 있습니다:");
+  if (swaggerUrl) {
+    console.log(`  swagshot list --url "${swaggerUrl}"`);
+    console.log(`  swagshot generate --url "${swaggerUrl}" --tag <컨트롤러명>`);
+  } else {
+    console.log(`  swagshot list --url <swagger-json-url>`);
+    console.log(`  swagshot generate --url <swagger-json-url> --tag <컨트롤러명>`);
+  }
+}

package/src/cli/commands/list.ts

@@ -0,0 +1,31 @@
+import { fetchSwaggerSpec, getControllerTags } from "../../lib/fetchSwagger";
+
+interface ListOptions {
+  url: string;
+}
+
+export async function listCommand(options: ListOptions) {
+  console.log(`\n📡 Swagger 스펙 가져오는 중... ${options.url}`);
+
+  let spec;
+  try {
+    spec = await fetchSwaggerSpec(options.url);
+  } catch (e) {
+    console.error(`❌ Swagger 스펙을 가져오지 못했습니다.\n${e instanceof Error ? e.message : String(e)}`);
+    process.exit(1);
+  }
+
+  const tags = getControllerTags(spec);
+
+  if (tags.length === 0) {
+    console.log("❌ 태그가 없습니다.");
+    return;
+  }
+
+  console.log(`\n📋 컨트롤러 태그 목록 (${tags.length}개):\n`);
+  tags.forEach((t, i) => console.log(`  ${i + 1}. ${t}`));
+
+  console.log("\n사용법:");
+  console.log(`  swagshot generate --url "${options.url}" --tag <태그명>`);
+  console.log(`  swagshot generate --url "${options.url}" --all`);
+}

package/src/cli/index.ts

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { initCommand } from "./commands/init";
+import { generateCommand } from "./commands/generate";
+import { listCommand } from "./commands/list";
+import { configCommand } from "./commands/config";
+
+const program = new Command();
+
+program
+  .name("swagshot")
+  .description("Swagger-powered API & type generator")
+  .version("0.1.0");
+
+program
+  .command("init")
+  .description("프로젝트 초기 설정 (.swagshot.json 생성)")
+  .option("--root <path>", "프로젝트 루트 경로 (기본값: 현재 디렉토리)")
+  .action(initCommand);
+
+program
+  .command("generate")
+  .description("Swagger 스펙으로 API 함수와 TypeScript 타입 생성")
+  .requiredOption("--url <url>", "Swagger JSON URL 또는 파일 경로")
+  .option("--tag <tag>", "생성할 컨트롤러 태그 (없으면 목록 표시)")
+  .option("--all", "모든 컨트롤러 생성")
+  .option("--include-deprecated", "deprecated 엔드포인트 포함")
+  .action(generateCommand);
+
+program
+  .command("list")
+  .description("Swagger 스펙의 컨트롤러 태그 목록 조회")
+  .requiredOption("--url <url>", "Swagger JSON URL 또는 파일 경로")
+  .action(listCommand);
+
+program
+  .command("config")
+  .description("프로젝트 설정 변경")
+  .argument("<action>", "set")
+  .argument("<key>", "설정 키 (예: apiDir, typesDir, httpClient)")
+  .argument("<value>", "설정 값")
+  .action(configCommand);
+
+program.parse();