@cartanova/qgrid-cli 1.0.1 → 1.0.2

package/bundle/src/i18n/sd.generated.ts

@@ -0,0 +1,384 @@
+/**
+ * @generated
+ * 직접 수정하지 마세요.
+ */
+
+import { Sonamu } from "sonamu";
+
+const DEFAULT_LOCALE = "ko" as const;
+const SUPPORTED_LOCALES = ["ko", "en"] as const;
+function getCurrentLocale(): (typeof SUPPORTED_LOCALES)[number] {
+  try {
+    const ctx = Sonamu.getContext();
+    return (ctx.locale as (typeof SUPPORTED_LOCALES)[number]) ?? DEFAULT_LOCALE;
+  } catch (_) {
+    return DEFAULT_LOCALE;
+  }
+}
+
+import en from "./en";
+import ko from "./ko";
+
+// react-components i18n keys
+const rcKeysKo = {
+  // AsyncSelect Component
+  "rc.asyncSelect.loading": "로딩 중...",
+  "rc.asyncSelect.noOptions": "옵션이 없습니다",
+  "rc.asyncSelect.noResults": "검색 결과가 없습니다",
+  "rc.asyncSelect.selectPlaceholder": "선택하세요...",
+
+  // Combobox Component
+  "rc.combobox.noResults": "검색 결과가 없습니다",
+  "rc.combobox.selectPlaceholder": "선택하세요...",
+
+  // DatePicker Component
+  "rc.datePicker.pickDate": "날짜 선택",
+  "rc.datePicker.placeholder": "날짜 선택",
+  "rc.datePicker.selectDate": "날짜 선택",
+
+  // DateSelectorMultiple Component
+  "rc.dateSelectorMultiple.addDate": "날짜 추가",
+  "rc.dateSelectorMultiple.dateRange": "기간",
+  "rc.dateSelectorMultiple.placeholder": "날짜 선택",
+  "rc.dateSelectorMultiple.singleDate": "단일",
+
+  // FileInput Component
+  "rc.fileInput.browseFiles": "파일 찾기",
+  "rc.fileInput.dropZone": "파일을 드래그하거나 클릭하여 업로드",
+  "rc.fileInput.filePlaceholder": "파일",
+  "rc.fileInput.imagePlaceholder": "이미지",
+  "rc.fileInput.maxFilesExceeded": (maxFiles: number) =>
+    `최대 ${maxFiles}개 파일만 업로드 가능합니다`,
+  "rc.fileInput.pending": "대기 중",
+  "rc.fileInput.remove": "제거",
+  "rc.fileInput.uploadFailed": "업로드 실패",
+  "rc.fileInput.uploading": "업로드 중...",
+
+  // MonthPickerMultiple Component
+  "rc.monthPickerMultiple.addMonth": "월 추가",
+  "rc.monthPickerMultiple.dateRange": "기간",
+  "rc.monthPickerMultiple.endDate": "종료일",
+  "rc.monthPickerMultiple.placeholder": "월 선택",
+  "rc.monthPickerMultiple.singleDate": "단일",
+  "rc.monthPickerMultiple.startDate": "시작일",
+
+  // MultiSelect Component
+  "rc.multiSelect.clear": "전체 해제",
+  "rc.multiSelect.close": "닫기",
+  "rc.multiSelect.moreItems": (count: number) => `+${count}개 더보기`,
+  "rc.multiSelect.noOptions": "옵션이 없습니다",
+  "rc.multiSelect.noOptionsSelected": "선택된 옵션이 없습니다",
+  "rc.multiSelect.noResults": "검색 결과가 없습니다",
+  "rc.multiSelect.optionsCount": (count: number) => `${count}개 옵션`,
+  "rc.multiSelect.selectAll": "전체 선택",
+  "rc.multiSelect.selectPlaceholder": "선택하세요...",
+
+  // Pagination Component
+  "rc.pagination.next": "다음",
+  "rc.pagination.previous": "이전",
+  "rc.pagination.showing": (start: number, end: number, total: number) =>
+    `${total}개 중 ${start}-${end}`,
+
+  // Calendar Component
+  "rc.calendar.month.0": "1월",
+  "rc.calendar.month.1": "2월",
+  "rc.calendar.month.2": "3월",
+  "rc.calendar.month.3": "4월",
+  "rc.calendar.month.4": "5월",
+  "rc.calendar.month.5": "6월",
+  "rc.calendar.month.6": "7월",
+  "rc.calendar.month.7": "8월",
+  "rc.calendar.month.8": "9월",
+  "rc.calendar.month.9": "10월",
+  "rc.calendar.month.10": "11월",
+  "rc.calendar.month.11": "12월",
+
+  // Sonamu Filter Component
+  "rc.sonamuFilter.title": "소나무 필터",
+  "rc.sonamuFilter.apply": "적용",
+  "rc.sonamuFilter.reset": "초기화",
+  "rc.sonamuFilter.addRule": "규칙 추가",
+  "rc.sonamuFilter.noRulesYet": '아직 규칙이 없습니다. "+ 규칙 추가"를 클릭하여 시작하세요.',
+  "rc.sonamuFilter.selectField": "필드 선택",
+  "rc.sonamuFilter.selectOperator": "연산자 선택",
+  "rc.sonamuFilter.selectOperatorFirst": "먼저 연산자를 선택하세요",
+  "rc.sonamuFilter.enterValue": "값 입력",
+  "rc.sonamuFilter.enterNumber": "숫자 입력",
+  "rc.sonamuFilter.notSupported": "지원하지 않음",
+  "rc.sonamuFilter.startDate": "시작일",
+  "rc.sonamuFilter.endDate": "종료일",
+  "rc.sonamuFilter.appliedFilters": "🌲 적용된 소나무 필터",
+
+  // Common
+  "rc.common.cancel": "취소",
+  "rc.common.save": "저장",
+};
+
+const rcKeysEn = {
+  // AsyncSelect Component
+  "rc.asyncSelect.loading": "Loading...",
+  "rc.asyncSelect.noOptions": "No options",
+  "rc.asyncSelect.noResults": "No results",
+  "rc.asyncSelect.selectPlaceholder": "Select...",
+
+  // Combobox Component
+  "rc.combobox.noResults": "No results",
+  "rc.combobox.selectPlaceholder": "Select...",
+
+  // DatePicker Component
+  "rc.datePicker.pickDate": "Pick date",
+  "rc.datePicker.placeholder": "Pick date",
+  "rc.datePicker.selectDate": "Select date",
+
+  // DateSelectorMultiple Component
+  "rc.dateSelectorMultiple.addDate": "Add date",
+  "rc.dateSelectorMultiple.dateRange": "Range",
+  "rc.dateSelectorMultiple.placeholder": "Pick date",
+  "rc.dateSelectorMultiple.singleDate": "Single",
+
+  // FileInput Component
+  "rc.fileInput.browseFiles": "Browse files",
+  "rc.fileInput.dropZone": "Drag files here or click to upload",
+  "rc.fileInput.filePlaceholder": "File",
+  "rc.fileInput.imagePlaceholder": "Image",
+  "rc.fileInput.maxFilesExceeded": (maxFiles: number) => `Maximum ${maxFiles} files allowed`,
+  "rc.fileInput.pending": "Pending",
+  "rc.fileInput.remove": "Remove",
+  "rc.fileInput.uploadFailed": "Upload failed",
+  "rc.fileInput.uploading": "Uploading...",
+
+  // MonthPickerMultiple Component
+  "rc.monthPickerMultiple.addMonth": "Add month",
+  "rc.monthPickerMultiple.dateRange": "Range",
+  "rc.monthPickerMultiple.endDate": "End date",
+  "rc.monthPickerMultiple.placeholder": "Pick month",
+  "rc.monthPickerMultiple.singleDate": "Single",
+  "rc.monthPickerMultiple.startDate": "Start date",
+
+  // MultiSelect Component
+  "rc.multiSelect.clear": "Clear all",
+  "rc.multiSelect.close": "Close",
+  "rc.multiSelect.moreItems": (count: number) => `+${count} more`,
+  "rc.multiSelect.noOptions": "No options",
+  "rc.multiSelect.noOptionsSelected": "No options selected",
+  "rc.multiSelect.noResults": "No results",
+  "rc.multiSelect.optionsCount": (count: number) => `${count} options`,
+  "rc.multiSelect.selectAll": "Select all",
+  "rc.multiSelect.selectPlaceholder": "Select...",
+
+  // Pagination Component
+  "rc.pagination.next": "Next",
+  "rc.pagination.previous": "Previous",
+  "rc.pagination.showing": (start: number, end: number, total: number) =>
+    `Showing ${start}-${end} of ${total}`,
+
+  // Calendar Component
+  "rc.calendar.month.0": "January",
+  "rc.calendar.month.1": "February",
+  "rc.calendar.month.2": "March",
+  "rc.calendar.month.3": "April",
+  "rc.calendar.month.4": "May",
+  "rc.calendar.month.5": "June",
+  "rc.calendar.month.6": "July",
+  "rc.calendar.month.7": "August",
+  "rc.calendar.month.8": "September",
+  "rc.calendar.month.9": "October",
+  "rc.calendar.month.10": "November",
+  "rc.calendar.month.11": "December",
+
+  // Sonamu Filter Component
+  "rc.sonamuFilter.title": "Sonamu Filter",
+  "rc.sonamuFilter.apply": "Apply",
+  "rc.sonamuFilter.reset": "Reset",
+  "rc.sonamuFilter.addRule": "Add Rule",
+  "rc.sonamuFilter.noRulesYet": 'No rules yet. Click "+ Add Rule" to start.',
+  "rc.sonamuFilter.selectField": "Select field",
+  "rc.sonamuFilter.selectOperator": "Operator",
+  "rc.sonamuFilter.selectOperatorFirst": "Select operator first",
+  "rc.sonamuFilter.enterValue": "Enter value",
+  "rc.sonamuFilter.enterNumber": "Enter number",
+  "rc.sonamuFilter.notSupported": "Not supported",
+  "rc.sonamuFilter.startDate": "Start date",
+  "rc.sonamuFilter.endDate": "End date",
+  "rc.sonamuFilter.appliedFilters": "🌲 Applied SonamuFilters",
+
+  // Common
+  "rc.common.cancel": "Cancel",
+  "rc.common.save": "Save",
+} as const;
+
+// entity.json에서 추출한 entity labels (defaultLocale 전용)
+const entityLabels = {
+  "entity.RequestLog": "RequestLog",
+  "entity.RequestLog.id": "ID",
+  "entity.RequestLog.created_at": "등록일시",
+  "entity.RequestLog.token_name": "토큰 이름",
+  "entity.RequestLog.query": "prompt 전문",
+  "entity.RequestLog.response": "llm 응답 전문",
+  "entity.RequestLog.input_tokens": "입력 토큰",
+  "entity.RequestLog.output_tokens": "출력 토큰",
+  "entity.RequestLog.cache_read_tokens": "캐시 읽기 토큰",
+  "entity.RequestLog.cache_creation_tokens": "캐시 생성 토큰",
+  "entity.RequestLog.duration_ms": "응답 소요시간(ms)",
+  "enum.RequestLogOrderBy.id-desc": "ID최신순",
+  "enum.RequestLogSearchField.id": "ID",
+  "enum.RequestLogSearchField.token_name": "토큰이름",
+  "enum.RequestLogSearchField.query": "쿼리",
+  "entity.Token": "Token",
+  "entity.Token.id": "ID",
+  "entity.Token.created_at": "등록일시",
+  "entity.Token.token": "access_token",
+  "entity.Token.name": "토큰 이름",
+  "entity.Token.refresh_token": "refresh_token",
+  "entity.Token.expires_at": "만료 시각 (epoch ms)",
+  "entity.Token.account_uuid": "Anthropic 계정 UUID",
+  "entity.Token.active": "활성 여부",
+  "enum.TokenOrderBy.id-desc": "ID최신순",
+  "enum.TokenSearchField.id": "ID",
+  "enum.TokenSearchField.name": "이름",
+} as const;
+
+// defaultLocale의 dictionary를 기준으로 키 추출
+type RCKeys = typeof rcKeysKo;
+type ProjectDictionary = typeof ko;
+type EntityLabels = typeof entityLabels;
+type RawMergedDictionary = RCKeys &
+  Omit<EntityLabels, keyof (RCKeys & ProjectDictionary)> &
+  ProjectDictionary;
+
+// 키는 유지하되, 값 타입은 string 또는 함수로 일반화 (다른 locale의 리터럴 타입 충돌 방지)
+export type MergedDictionary = {
+  [K in keyof RawMergedDictionary]: RawMergedDictionary[K] extends (...args: infer P) => string
+    ? (...args: P) => string
+    : string;
+};
+export type DictKey = keyof MergedDictionary;
+export type LocalizedString = string & { __brand: "LocalizedString" };
+
+export function defineLocale(dict: Partial<MergedDictionary>) {
+  return dict;
+}
+
+// 각 locale별로 rc-keys + entity labels + 프로젝트 dict 합침
+const dictionaries: Record<string, Partial<MergedDictionary>> = {
+  ko: { ...rcKeysKo, ...entityLabels, ...ko },
+  en: { ...rcKeysEn, ...en },
+};
+
+type SDReturnType<K extends DictKey> = MergedDictionary[K] extends (...args: infer P) => string
+  ? (...args: P) => LocalizedString
+  : LocalizedString;
+
+function getDictValue<K extends DictKey>(key: K, locale: string): SDReturnType<K> {
+  // 1. 지정된 locale에서 조회
+  const dict = dictionaries[locale];
+  if (dict?.[key] !== undefined) {
+    return dict[key] as unknown as SDReturnType<K>;
+  }
+
+  // 2. default locale에서 조회
+  if (locale !== DEFAULT_LOCALE && dictionaries[DEFAULT_LOCALE]?.[key] !== undefined) {
+    return dictionaries[DEFAULT_LOCALE][key] as unknown as SDReturnType<K>;
+  }
+
+  // 3. supported locales 순회
+  for (const supportedLocale of SUPPORTED_LOCALES) {
+    if (supportedLocale !== locale && supportedLocale !== DEFAULT_LOCALE) {
+      if (dictionaries[supportedLocale]?.[key] !== undefined) {
+        return dictionaries[supportedLocale][key] as unknown as SDReturnType<K>;
+      }
+    }
+  }
+
+  // 4. 모두 실패 시 key 반환
+  return key as unknown as SDReturnType<K>;
+}
+
+/**
+ * Sonamu Dictionary 함수
+ * locale에 맞는 번역 텍스트를 반환합니다.
+ *
+ * @example
+ * SD("common.save")  // → "저장" (LocalizedString)
+ * SD("user.notFound")(1)  // → "존재하지 않는 User ID 1" (LocalizedString)
+ */
+export function SD<K extends DictKey>(key: K): SDReturnType<K> {
+  const locale = getCurrentLocale();
+  return getDictValue(key, locale);
+}
+
+/**
+ * 특정 locale의 번역 텍스트를 반환하는 함수를 생성합니다.
+ *
+ * @example
+ * const EN = SD.locale("en");
+ * EN("common.save")  // → "Save"
+ */
+SD.locale =
+  (locale: (typeof SUPPORTED_LOCALES)[number]) =>
+  <K extends DictKey>(key: K): SDReturnType<K> => {
+    return getDictValue(key, locale);
+  };
+
+// Localized 가능한 Column 타입 계산
+type LocalizedBaseColumn<T> = {
+  [K in keyof T & string]: K extends `${infer Base}_${(typeof SUPPORTED_LOCALES)[number]}`
+    ? Base
+    : K;
+}[keyof T & string];
+
+/**
+ * locale에 따라 적절한 컬럼 값을 반환합니다.
+ * DB에 name, name_ko, name_en처럼 localized column이 있을 때 사용합니다.
+ *
+ * 우선순위 (지원 로케일은 ko/jp/en이고, 서비스의 기본 로케일은 ko, 사용자의 로케일은 jp일 때): column_jp → column → column_ko → column_en
+ * 우선순위 (지원 로케일은 ko/jp/en이고, 서비스의 기본 로케일은 en, 사용자의 로케일은 ko일 때): column_ko → column → column_en → column_jp
+ *
+ * @example
+ * localizedColumn(tag, "name")
+ */
+export function localizedColumn<
+  T extends Record<string, unknown>,
+  K extends LocalizedBaseColumn<T>,
+>(row: T, column: K): string | undefined {
+  const locale = getCurrentLocale();
+  const otherLocales = SUPPORTED_LOCALES.filter(
+    (l: string) => l !== locale && l !== DEFAULT_LOCALE,
+  );
+  const localizedKey = (column: K, locale: (typeof SUPPORTED_LOCALES)[number]) =>
+    `${column}_${locale}`;
+  const keys = [
+    localizedKey(column, locale),
+    column,
+    localizedKey(column, DEFAULT_LOCALE),
+    ...otherLocales.map((l) => localizedKey(column, l)),
+  ];
+
+  for (const key of keys) {
+    if (!(key in row)) {
+      continue;
+    }
+
+    if (row[key] !== null && row[key] !== undefined && row[key] !== "") {
+      return String(row[key]);
+    }
+  }
+
+  return undefined;
+}
+
+/**
+ * Enum의 localized labels를 Proxy로 반환합니다.
+ * Select 컴포넌트 등에서 EnumLabel[key] 대신 사용합니다.
+ *
+ * @example
+ * SD.enumLabels("TagOrderBy")[key]  // → 현재 locale의 라벨
+ */
+SD.enumLabels = (enumName: string): Record<string, LocalizedString> => {
+  return new Proxy({} as Record<string, LocalizedString>, {
+    get(_, key: string) {
+      const dictKey = `enum.${enumName}.${key}` as DictKey;
+      return getDictValue(dictKey, getCurrentLocale());
+    },
+  });
+};

package/bundle/src/index.ts

@@ -0,0 +1,6 @@
+import { Sonamu } from "sonamu";
+
+async function bootstrap() {
+  await Sonamu.createServer();
+}
+bootstrap();

package/bundle/src/sonamu.config.ts

@@ -0,0 +1,248 @@
+import path from "path";
+
+import { getConsoleSink } from "@logtape/logtape";
+import { getPrettyFormatter } from "@logtape/pretty";
+import dotenv from "dotenv";
+import { CachePresets, defineConfig } from "sonamu";
+import { drivers as cacheDrivers, store } from "sonamu/cache";
+import { drivers } from "sonamu/storage";
+
+dotenv.config({ path: path.join(import.meta.dirname, "../.env") });
+
+const host = process.env.HOST ?? "localhost";
+const port = Number(process.env.PORT ?? 44900);
+
+export default defineConfig({
+  projectName: process.env.PROJECT_NAME ?? "SonamuProject",
+  database: {
+    name: process.env.QGRID_DB_NAME ?? "qgrid",
+    defaultOptions: {
+      connection: {
+        host: process.env.QGRID_DB_HOST ?? "localhost",
+        port: Number(process.env.QGRID_DB_PORT ?? 44901),
+        user: process.env.QGRID_DB_USER ?? "postgres",
+        password: process.env.QGRID_DB_PASSWORD ?? "postgres",
+      },
+    },
+    environments: {
+      production: {
+        connection: {
+          host: process.env.DEV0_DB_HOST,
+          port: Number(process.env.DEV0_DB_PORT),
+          database: process.env.DATABASE_NAME,
+          user: process.env.DEV0_DB_USER,
+          password: process.env.DEV0_DB_PASSWORD,
+        },
+      },
+      fixture: {
+        connection: {
+          host: process.env.DEV0_DB_HOST,
+          port: Number(process.env.DEV0_DB_PORT),
+          database: process.env.DATABASE_NAME,
+          user: process.env.DEV0_DB_USER,
+          password: process.env.DEV0_DB_PASSWORD,
+        },
+      },
+    },
+  },
+  api: {
+    dir: "api",
+    timezone: "Asia/Seoul",
+    route: {
+      prefix: "/api",
+    },
+  },
+  i18n: {
+    defaultLocale: "ko",
+    supportedLocales: ["ko", "en"],
+  },
+  sync: {
+    targets: ["web"],
+  },
+  slackConfirm:
+    process.env.SLACK_BOT_TOKEN && process.env.SLACK_CHANNEL_ID
+      ? {
+          targets: ["development_master", "production_master"],
+          botToken: process.env.SLACK_BOT_TOKEN ?? "",
+          channelId: process.env.SLACK_CHANNEL_ID ?? "",
+        }
+      : undefined,
+  test: {
+    parallel: true,
+    maxWorkers: 4,
+    devRunner: { enabled: true },
+  },
+  logging: {
+    sinks: {
+      console: getConsoleSink({
+        formatter: getPrettyFormatter({
+          timestamp: "time",
+          categoryWidth: 20,
+          categoryTruncate: "middle",
+        }),
+      }),
+    },
+    loggers: [
+      {
+        category: ["sonamu"],
+        sinks: ["console"],
+        lowestLevel: process.env.NODE_ENV === "test" ? "warning" : "debug",
+      },
+    ],
+  },
+  server: {
+    listen: { port, host },
+    plugins: {
+      formbody: true,
+      qs: true,
+      multipart: { limits: { fileSize: 1024 * 1024 * 30 } },
+      static: {
+        root: path.join(import.meta.dirname, "/../", "public"),
+        prefix: "/api/public",
+      },
+      custom: (server) => {
+        // OAuth 콜백 — Anthropic이 /callback으로 리다이렉트
+        server.get("/callback", async (request, reply) => {
+          const { code, state } = request.query as { code?: string; state?: string };
+          if (!code || !state) {
+            return reply.redirect("/?oauth=error&reason=missing_params");
+          }
+          // Frame의 oauthCallback으로 위임
+          try {
+            const { QgridFrame } = await import("./application/qgrid/qgrid.frame");
+            await QgridFrame.handleOAuthCallback(code, state, reply);
+          } catch (e) {
+            return reply.redirect(
+              `/?oauth=error&reason=${encodeURIComponent((e as Error).message)}`,
+            );
+          }
+        });
+      },
+    },
+    apiConfig: {
+      contextProvider: (defaultContext, request) => {
+        return {
+          ...defaultContext,
+          ip: request.ip,
+          body: request.body,
+        };
+      },
+      guardHandler: (_guard, _request, _api) => {
+        if (_guard === "user") {
+          console.log("user guard");
+        }
+        console.log("NOTHING YET");
+      },
+      cacheControlHandler: (req) => {
+        switch (req.type) {
+          case "assets":
+            // Hash 포함된 파일: 영구 캐시
+            if (req.path.match(/-[a-f0-9]+\./)) {
+              return CachePresets.immutable;
+            }
+            return CachePresets.longLived;
+
+          case "api":
+            // GET 요청만 캐싱 고려
+            if (req.method === "GET") {
+              // 특정 경로는 짧은 캐시
+              if (req.path.startsWith("/api/static-data")) {
+                return CachePresets.shortLived;
+              }
+              if (req.path.startsWith("/api/terms")) {
+                return CachePresets.mediumLived;
+              }
+            }
+            // 기본: 캐시 없음
+            return CachePresets.noCache;
+
+          case "ssr":
+            // SSR 페이지: 10초 캐시
+            return CachePresets.ssr;
+
+          case "csr":
+            // CSR fallback (index.html): 1분 캐시
+            return CachePresets.shortLived;
+        }
+      },
+    },
+    storage: {
+      drivers: {
+        fs: drivers.fs({
+          location: path.join(import.meta.dirname, "/../public/uploaded"),
+          visibility: "public",
+          urlBuilder: {
+            async generateURL(key) {
+              return `/api/public/uploaded/${key}`;
+            },
+            async generateSignedURL(key) {
+              return `/api/public/uploaded/${key}`;
+            },
+          },
+        }),
+        s3: drivers.s3({
+          credentials: {
+            accessKeyId: process.env.AWS_ACCESS_KEY_ID ?? "",
+            secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY ?? "",
+          },
+          region: process.env.S3_REGION ?? "ap-northeast-2",
+          bucket: process.env.S3_BUCKET ?? "sonamu_default_bucket",
+          visibility: "private",
+        }),
+      },
+    },
+    cache: {
+      default: "main",
+      stores: {
+        main: store().useL1Layer(cacheDrivers.memory({ maxSize: "50mb" })),
+      },
+      ttl: "5m",
+      prefix: "",
+    },
+    lifecycle: {
+      onStart: async () => {
+        // DB 마이그레이션 자동 실행 (테이블 없으면 생성)
+        try {
+          const { TokenModel } = await import("./application/token/token.model");
+          const knex = TokenModel.getDB("w");
+          const migrationsDir = path.join(import.meta.dirname, "../src/migrations");
+          const [batch, log] = await knex.migrate.latest({
+            directory: migrationsDir,
+          });
+          if (log.length > 0) {
+            console.log(`✓ Migration: ${log.length} applied (batch ${batch})`);
+            log.forEach((name: string) => console.log(`  ✓ ${name}`));
+          }
+        } catch (e) {
+          console.warn(`⚠ Migration skipped: ${(e as Error).message}`);
+        }
+
+        // Pool 초기화
+        const { initPool } = await import("./application/qgrid/pool");
+        try {
+          const { TokenModel } = await import("./application/token/token.model");
+          const entries = await TokenModel.findActive("A");
+          const tokens = entries.map((e) => e.token);
+          const pool = initPool(tokens);
+          console.log(
+            `🌲 Server listening on http://${host}:${port} (${pool.workers.size} tokens loaded)`,
+          );
+        } catch (e) {
+          console.warn(`⚠ Pool init failed: ${(e as Error).message}`);
+          initPool([]);
+          console.log(`🌲 Server listening on http://${host}:${port} (no tokens)`);
+        }
+      },
+      onShutdown: () => {
+        console.log("graceful shutdown");
+      },
+      onError: (error, _request, reply) => {
+        console.error(error);
+        reply.status(500).send({
+          name: error.name,
+          message: error.message,
+        });
+      },
+    },
+  },
+});

package/bundle/src/testing/fixture.ts

@@ -0,0 +1,6 @@
+import { createFixtureLoader } from "sonamu/test";
+
+export const loadFixtures = createFixtureLoader({
+  // Define your fixtures...
+  fixture01: async () => {},
+});

package/bundle/src/testing/global.ts

@@ -0,0 +1,6 @@
+import dotenv from "dotenv";
+
+dotenv.config();
+
+// sonamu.config.ts의 test 설정을 기반으로 병렬 테스트 환경을 구성합니다.
+export { setup } from "sonamu/test";