create-sonamu 0.0.1 → 0.0.3

package/template/src/packages/api/src/i18n/en.ts

@@ -0,0 +1,59 @@
+import { plural } from "sonamu/dict";
+
+/**
+ * Project EN Dictionary
+ */
+export default {
+  "common.all": "All",
+  "common.backToList": "Back to List",
+  "common.cancel": "Cancel",
+  "common.close": "Close",
+  "common.confirm": "Confirm",
+  "common.create": "Create",
+  "common.createdAt": "Created At",
+  "common.delete": "Delete",
+  "common.edit": "Edit",
+  "common.login": "Login",
+  "common.logout": "Logout",
+  "common.manage": "Manage",
+  "common.results": (count: number) =>
+    plural(count, { one: `${count} result`, other: `${count} results` }),
+  "common.save": "Save",
+  "common.search": "Search",
+  "common.searchPlaceholder": "Search...",
+  "common.searchType": "Search Type",
+  "common.sort": "Sort",
+  "confirm.delete": "Are you sure you want to delete?",
+  "confirm.save": "Do you want to save?",
+  "dashboard.adminMenu": "Admin Menu",
+  "dashboard.createdAt": "Joined",
+  "dashboard.email": "Email",
+  "dashboard.loginRequired": "Please login to continue.",
+  "dashboard.name": "Name",
+  "dashboard.role": "Role",
+  "dashboard.title": "Admin Dashboard",
+  "dashboard.welcome": "Welcome!",
+  "delete.confirm.description":
+    "This action cannot be undone. This will permanently delete this item.",
+  "delete.confirm.title": "Are you sure?",
+  "entity.create": (name: string) => `Create ${name}`,
+  "entity.edit": (name: string, id: number) => `Edit ${name} (#${id})`,
+  "entity.list": (name: string) => `${name} List`,
+  "entity.listManage": (name: string) => `Manage ${name} List`,
+  "error.alreadyProcessed": "Already processed",
+  "error.badRequest": "Bad request",
+  "error.duplicateRow": "Duplicate data",
+  "error.forbidden": "Forbidden",
+  "error.internalServerError": "Internal server error",
+  "error.notFound": "Not found",
+  "error.serviceUnavailable": "Service unavailable",
+  "error.unauthorized": "Unauthorized",
+  notFound: (name: string, id: number) => `${name} ID ${id} not found`,
+  "validation.email": "Invalid email format",
+  "validation.maxLength": (field: string, max: number) =>
+    `${field} must be at most ${max} characters`,
+  "validation.minLength": (field: string, min: number) =>
+    `${field} must be at least ${min} characters`,
+  "validation.required": (field: string) => `${field} is required`,
+  "validation.url": "Invalid URL format",
+};

package/template/src/packages/api/src/i18n/ko.ts

@@ -0,0 +1,57 @@
+import { josa } from "sonamu/dict";
+
+/**
+ * Project KO Dictionary
+ */
+export default {
+  "common.all": "전체",
+  "common.backToList": "목록으로",
+  "common.cancel": "취소",
+  "common.close": "닫기",
+  "common.confirm": "확인",
+  "common.create": "생성",
+  "common.createdAt": "등록",
+  "common.delete": "삭제",
+  "common.edit": "수정",
+  "common.login": "로그인",
+  "common.logout": "로그아웃",
+  "common.manage": "관리",
+  "common.results": (count: number) => `${count}개 결과`,
+  "common.save": "저장",
+  "common.search": "검색",
+  "common.searchPlaceholder": "검색...",
+  "common.searchType": "검색 유형",
+  "common.sort": "정렬",
+  "confirm.delete": "정말 삭제하시겠습니까?",
+  "confirm.save": "저장하시겠습니까?",
+  "dashboard.adminMenu": "관리 메뉴",
+  "dashboard.createdAt": "가입일",
+  "dashboard.email": "이메일",
+  "dashboard.loginRequired": "로그인이 필요합니다.",
+  "dashboard.name": "이름",
+  "dashboard.role": "역할",
+  "dashboard.title": "관리자 대시보드",
+  "dashboard.welcome": "환영합니다!",
+  "delete.confirm.description": "이 작업은 취소할 수 없습니다. 항목이 영구적으로 삭제됩니다.",
+  "delete.confirm.title": "정말 삭제하시겠습니까?",
+  "entity.create": (name: string) => `${name} 생성`,
+  "entity.edit": (name: string, id: number) => `${name} 수정 (#${id})`,
+  "entity.list": (name: string) => `${name} 목록`,
+  "entity.listManage": (name: string) => `${name} 목록 관리`,
+  "error.alreadyProcessed": "이미 처리되었습니다",
+  "error.badRequest": "잘못된 요청입니다",
+  "error.duplicateRow": "중복된 데이터입니다",
+  "error.forbidden": "권한이 없습니다",
+  "error.internalServerError": "서버 오류가 발생했습니다",
+  "error.notFound": "찾을 수 없습니다",
+  "error.serviceUnavailable": "서비스를 사용할 수 없습니다",
+  "error.unauthorized": "인증이 필요합니다",
+  notFound: (name: string, id: number) => `존재하지 않는 ${name} ID ${id}`,
+  "validation.email": "올바른 이메일 형식이 아닙니다",
+  "validation.maxLength": (field: string, max: number) =>
+    `${field}${josa(field, "은는")} 최대 ${max}자까지 입력할 수 있습니다`,
+  "validation.minLength": (field: string, min: number) =>
+    `${field}${josa(field, "은는")} 최소 ${min}자 이상이어야 합니다`,
+  "validation.required": (field: string) => `${josa(field, "은는")} 필수입니다`,
+  "validation.url": "올바른 URL 형식이 아닙니다",
+};

package/template/src/packages/api/src/index.ts

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

package/template/src/packages/api/src/migrations/.gitkeep

@@ -0,0 +1 @@
+# This directory will contain database migration files generated by Sonamu UI.

package/template/src/packages/api/src/sonamu.config.ts

@@ -0,0 +1,162 @@
+import path from "node:path";
+import { CachePresets, defineConfig } from "sonamu";
+import { drivers as cacheDrivers, store } from "sonamu/cache";
+import { drivers } from "sonamu/storage";
+
+const host = "localhost";
+const port = 1028;
+
+export default defineConfig({
+  projectName: process.env.PROJECT_NAME ?? "SonamuProject",
+  api: {
+    dir: "api",
+    timezone: "Asia/Seoul",
+    route: {
+      prefix: "/api",
+    },
+  },
+  i18n: {
+    defaultLocale: "ko",
+    supportedLocales: ["ko", "en"],
+  },
+  sync: {
+    targets: ["web"],
+  },
+  database: {
+    database: "pg",
+    name: process.env.DATABASE_NAME ?? "database_name",
+    defaultOptions: {
+      connection: {
+        host: process.env.DB_HOST || "0.0.0.0",
+        port: Number(process.env.DB_PORT) || 5432,
+        user: process.env.DB_USER || "postgres",
+        password: process.env.DB_PASSWORD,
+      },
+    },
+  },
+
+  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",
+      },
+      session: {
+        secret: process.env.SESSION_SECRET || "sonamu-secret-key-change-this-in-production",
+        salt: process.env.SESSION_SALT || "mq9hDxBCDbsQDR6N",
+        cookie: {
+          domain: "localhost",
+          path: "/",
+          maxAge: 60 * 60 * 24 * 365 * 10,
+        },
+      },
+      custom: (_server) => {
+        // nothing yet
+      },
+    },
+
+    auth: true,
+    // auth: {
+    //   userSerializer: async (user, _request) => user,
+    //   userDeserializer: async (serialized, _request) => serialized,
+    // },
+
+    apiConfig: {
+      contextProvider: (defaultContext, request) => {
+        return {
+          ...defaultContext,
+          ip: request.ip,
+          session: request.session,
+          body: request.body,
+        };
+      },
+      guardHandler: (_guard, _request, _api) => {
+        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;
+              }
+            }
+            // 기본: 캐시 없음
+            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: () => {
+        console.log(`🌲 Server listening on http://${host}:${port}`);
+      },
+      onShutdown: () => {
+        console.log("graceful shutdown");
+      },
+      onError: (error, _request, reply) => {
+        console.error(error);
+        reply.status(500).send({
+          name: error.name,
+          message: error.message,
+        });
+      },
+    },
+  },
+});

package/template/src/packages/api/src/testing/fixture.ts

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

package/template/src/packages/api/src/testing/global.ts

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

package/template/src/packages/api/src/testing/setup-mocks.ts

@@ -0,0 +1,44 @@
+import type { MakeDirectoryOptions, Mode, PathLike, RmOptions } from "fs";
+import type { FileHandle } from "fs/promises";
+import { Naite } from "sonamu";
+import { vi } from "vitest";
+
+// GlobalMock: fs/promises
+vi.mock("fs/promises", async (importOriginal) => {
+  const actual = (await importOriginal()) as typeof import("fs/promises");
+  return {
+    ...actual,
+    access: vi.fn((path: PathLike, mode?: number) => {
+      const vfs = Naite.get("mock:fs/promises:virtualFileSystem").result();
+      if (vfs.some((v) => v === path)) {
+        return Promise.resolve();
+      }
+
+      return actual.access(path, mode);
+    }),
+    mkdir: vi.fn(
+      async (
+        path: PathLike,
+        options?: MakeDirectoryOptions | Mode | null,
+      ): Promise<string | undefined> => {
+        Naite.t("fs:mkdir", { path, options });
+        if (typeof options === "object" && options?.recursive) {
+          return typeof path === "string" ? path : path.toString();
+        }
+        return undefined;
+      },
+    ),
+    writeFile: vi.fn((path: PathLike | FileHandle, data: string | Buffer | Uint8Array) => {
+      const filePath = typeof path === "string" ? path : path.toString();
+
+      Naite.t(`fs/promises:writeFile`, { path: filePath, data });
+    }),
+    rm: vi.fn(async (path: PathLike, options?: RmOptions) => {
+      const filePath = typeof path === "string" ? path : path.toString();
+
+      Naite.t(`fs/promises:rm`, { path: filePath, options });
+      // 실제 삭제하지 않고 기록만 함
+      return Promise.resolve();
+    }),
+  };
+});

package/template/src/packages/api/src/typings/fastify.d.ts

@@ -0,0 +1,7 @@
+/** biome-ignore-all lint/correctness/noUnusedImports: d.ts */
+import type fastify from "fastify";
+import type { UserSubsetSS } from "../application/sonamu.generated";
+
+declare module "fastify" {
+  export interface PassportUser extends UserSubsetSS {}
+}

package/template/src/packages/api/src/typings/sonamu.d.ts

@@ -0,0 +1,19 @@
+/** biome-ignore-all lint/correctness/noUnusedImports: d.ts */
+
+import type { Session } from "@fastify/secure-session";
+import {} from "sonamu";
+
+declare module "sonamu" {
+  export interface ContextExtend {
+    ip: string;
+    session: Session;
+  }
+
+  export interface GuardKeys {
+    query: true;
+    user: true;
+    admin: true;
+    // 새로운 커스텀 가드키를 추가하는 경우
+    // CustomGuardKey: true
+  }
+}

package/template/src/packages/api/src/utils/subset-loaders.ts

@@ -0,0 +1,11 @@
+import type { SubsetQuery } from "sonamu";
+
+export function getSubsetLoaders(subsets: string[], subsetQueries: Record<string, SubsetQuery>) {
+  return subsets.reduce(
+    (acc, subset) => {
+      acc[subset] = subsetQueries[subset]?.loaders ?? [];
+      return acc;
+    },
+    {} as Record<string, SubsetQuery["loaders"]>,
+  );
+}

package/template/src/packages/api/tsconfig.json

@@ -0,0 +1,60 @@
+{
+  "compilerOptions": {
+    /* Basic Options */
+    "target": "esnext",
+    "module": "esnext",
+    "outDir": "dist",
+    "sourceMap": true,
+    "lib": ["esnext", "dom"],
+
+    /* Strict Type-Checking Options */
+    "strict": true,
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "strictFunctionTypes": true,
+    "strictBindCallApply": true,
+    "strictPropertyInitialization": true,
+    "noImplicitThis": true,
+    "alwaysStrict": true,
+
+    /* Additional Checks */
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "useUnknownInCatchVariables": true,
+
+    /* Module Resolution Options */
+    "moduleResolution": "bundler",
+    "esModuleInterop": true,
+
+    /* Experimental Options */
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+
+    /* Advanced Options */
+    "forceConsistentCasingInFileNames": true,
+    "noErrorTruncation": true,
+
+    "resolveJsonModule": true,
+
+    "skipLibCheck": true,
+    "noUncheckedIndexedAccess": true
+  },
+  "include": ["src/**/*.ts", "src/**/*.json"],
+  "exclude": [
+    "node_modules",
+    "dist/*",
+    "public",
+    // "src/**/*.test.ts",
+    "src/**/*.test-hold.ts",
+    "src/**/*.ignore.ts",
+    "wasted_src/**",
+    "_templates/**",
+    "**/__mocks__/**",
+    "vite.config.ts"
+  ],
+  "tsc-alias": {
+    "resolveFullPaths": true
+  }
+}

package/template/src/packages/api/tsconfig.schemas.json

@@ -0,0 +1,5 @@
+{
+  "extends": "./tsconfig.json",
+  "include": ["src/sonamu.generated.ts"],
+  "exclude": ["src/**/*.types.ts"]
+}

package/template/src/packages/api/tsconfig.types.json

@@ -0,0 +1,5 @@
+{
+  "extends": "./tsconfig.json",
+  "include": ["src/**/*.types.ts"],
+  "references": [{ "path": "./tsconfig.schemas.json" }]
+}

package/template/src/packages/api/vitest.config.ts

@@ -0,0 +1,36 @@
+import { getSonamuTestConfig, NaiteVitestReporter } from "sonamu/test";
+import { defineConfig } from "vitest/config";
+import { PrioritySequencer } from "./custom-sequencer";
+
+export default defineConfig(async () => ({
+  plugins: [],
+  test: await getSonamuTestConfig({
+    include: ["src/**/*.test.ts"],
+    exclude: ["src/**/*.test-hold.ts", "**/node_modules/**", "**/.yarn/**", "**/dist/**"],
+    globals: true,
+    globalSetup: ["./src/testing/global.ts"],
+    setupFiles: ["./src/testing/setup-mocks.ts"],
+    sequence: {
+      sequencer: PrioritySequencer,
+    },
+    reporters: ["default", NaiteVitestReporter],
+    restoreMocks: true,
+    typecheck: {
+      enabled: true,
+      tsconfig: "./tsconfig.json",
+      include: ["src/**/*type-safety.test.ts"],
+    },
+    coverage: {
+      provider: "v8",
+      reporter: ["text", "html"],
+      include: ["src/**/*.ts"],
+      exclude: ["**/*.test.ts", "**/testing/**", "**/node_modules/**", "**/dist/**"],
+    },
+    includeTaskLocation: true,
+    server: {
+      deps: {
+        inline: ["sonamu"],
+      },
+    },
+  }),
+}));

package/template/src/packages/web/.sonamu.env

@@ -0,0 +1,2 @@
+API_HOST=localhost
+API_PORT=1028

package/template/src/{web → packages/web}/index.html

@@ -2,12 +2,12 @@
 <html lang="en">
   <head>
     <meta charset="UTF-8" />
-    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+    <link rel="icon" type="image/svg+xml" href="/sonamu.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>sonamu-tutorial</title>
+    <title>Sonamu Project</title>
   </head>
   <body>
     <div id="root"></div>
-    <script type="module" src="/src/main.tsx"></script>
+    <script type="module" src="/src/entry-client.tsx"></script>
   </body>
 </html>

package/template/src/packages/web/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "create-sonamu-web",
+  "private": true,
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Sonamu web client",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@sonamu-kit/react-components": "^0.1.6",
+    "@tanstack/react-query": "^5.90.12",
+    "@tanstack/react-router": "1.143.11",
+    "axios": "^1.13.2",
+    "clsx": "^2.1.1",
+    "dotenv": "^16",
+    "eventsource": "^4.1.0",
+    "jotai": "^2.14.0",
+    "qs": "^6.14.1",
+    "radashi": "^12.2.0",
+    "react": "^19.2.3",
+    "react-day-picker": "^8.10.1",
+    "react-dom": "^19.2.3",
+    "tailwind-merge": "^3.4.0",
+    "zod": "^4.1.12"
+  },
+  "devDependencies": {
+    "@iconify/json": "^2.2.421",
+    "@svgr/core": "^8.1.0",
+    "@svgr/plugin-jsx": "^8.1.0",
+    "@svgr/plugin-svgo": "^8.1.0",
+    "@tailwindcss/postcss": "^4.0.0",
+    "@tailwindcss/vite": "^4.1.17",
+    "@tanstack/react-router-devtools": "1.143.11",
+    "@tanstack/router-plugin": "1.143.11",
+    "@types/node": "25.0.7",
+    "@types/qs": "^6.14.0",
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react-swc": "^4.1.3",
+    "sass": "^1.92.1",
+    "tailwindcss": "^4.0.0",
+    "typescript": "^5.9.3",
+    "unplugin-icons": "0.20.2",
+    "vite": "7.3.0"
+  }
+}

package/template/src/packages/web/package.json.bak

@@ -0,0 +1,49 @@
+{
+  "name": "create-sonamu-web",
+  "private": true,
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Sonamu web client",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@sonamu-kit/react-components": "workspace:^",
+    "@tanstack/react-query": "catalog:",
+    "@tanstack/react-router": "catalog:",
+    "axios": "catalog:",
+    "clsx": "catalog:",
+    "dotenv": "catalog:",
+    "eventsource": "catalog:",
+    "jotai": "catalog:",
+    "qs": "catalog:",
+    "radashi": "catalog:",
+    "react": "catalog:",
+    "react-day-picker": "catalog:",
+    "react-dom": "catalog:",
+    "tailwind-merge": "catalog:",
+    "zod": "catalog:"
+  },
+  "devDependencies": {
+    "@iconify/json": "catalog:",
+    "@svgr/core": "catalog:",
+    "@svgr/plugin-jsx": "catalog:",
+    "@svgr/plugin-svgo": "catalog:",
+    "@tailwindcss/postcss": "catalog:",
+    "@tailwindcss/vite": "catalog:",
+    "@tanstack/react-router-devtools": "catalog:",
+    "@tanstack/router-plugin": "catalog:",
+    "@types/node": "catalog:",
+    "@types/qs": "catalog:",
+    "@types/react": "catalog:",
+    "@types/react-dom": "catalog:",
+    "@vitejs/plugin-react-swc": "catalog:",
+    "sass": "catalog:",
+    "tailwindcss": "catalog:",
+    "typescript": "catalog:",
+    "unplugin-icons": "catalog:",
+    "vite": "catalog:"
+  }
+}

package/template/src/packages/web/src/App.tsx

@@ -0,0 +1,17 @@
+import { type ReactNode, Suspense } from "react";
+
+interface AppProps {
+  children?: ReactNode;
+}
+
+function App({ children }: AppProps) {
+  return (
+    <div className="min-h-screen bg-gray-50">
+      <div className="max-w-7xl mx-auto">
+        <Suspense fallback={<div>Loading...</div>}>{children}</Suspense>
+      </div>
+    </div>
+  );
+}
+
+export default App;