sonamu 0.9.3 → 0.9.5

package/src/auth/audit-log-ingestor.ts

@@ -2,7 +2,7 @@ import { createHash } from "node:crypto";
 
 import { type Knex } from "knex";
 
-import { type AuditLogEvent } from "./audit-log-proxy-types";
+import { type AuditLogEvent } from "./audit-log/events";
 
 const AUDIT_EVENT_SOURCE = "better_auth";
 const AUDIT_EVENT_SOURCE_VERSION = "better-auth|@better-auth/infra";
@@ -48,7 +48,6 @@ const USER_EVENT_TYPES = new Set<string>([
   "profile_updated",
   "profile_image_updated",
   "email_verified",
-  "email_changed",
   "user_banned",
   "user_unbanned",
   "user_deleted",
@@ -139,9 +138,9 @@ function computeDedupeKey(parts: {
 }
 
 /**
- * Better Auth dash() 이벤트를 audit_events 테이블에 적재합니다.
+ * sonamuAuditLog 플러그인이 구성한 AuditLogEvent를 audit_events 테이블에 적재합니다.
  * ON CONFLICT (dedupe_key) DO NOTHING으로 중복을 silent 무시합니다.
- * auth.auditLog: true 설정 시 sonamu 내부에서 자동으로 호출됩니다.
+ * auth.plugins에 sonamuAuditLog() 추가 시 sonamu 내부에서 자동으로 호출됩니다.
  */
 export async function ingestAuditEvent(db: Knex, event: AuditLogEvent): Promise<void> {
   const eventData = event.eventData;

package/src/auth/index.ts

@@ -1,6 +1,8 @@
 export type { GenerateBetterAuthEntitiesOptions } from "./auth-generator";
 export { generateBetterAuthEntities } from "./auth-generator";
 export { ingestAuditEvent } from "./audit-log-ingestor";
+export { type AuditLogEvent } from "./audit-log/events";
+export { sonamuAuditLog } from "./audit-log/plugin";
 export { BASE_FIELD_MAPPINGS, betterAuthV1 } from "./better-auth-entities";
 export { sonamuKnexAdapter } from "./knex-adapter";
 

package/src/auth/plugins/entity-definitions/admin.ts

@@ -10,7 +10,7 @@ import { type BetterAuthEntityDef } from "./types";
  * - role: 사용자 역할 (기본값: "user")
  * - banned: 차단 여부
  * - ban_reason: 차단 사유
- * - ban_expires: 차단 만료 시간 (Unix timestamp)
+ * - ban_expires: 차단 만료 시간 (Date)
  *
  * Session 테이블:
  * - impersonated_by: 대리 로그인한 관리자 ID
@@ -43,9 +43,9 @@ export const adminEntityDef: BetterAuthEntityDef = {
       },
       {
         name: "ban_expires",
-        type: "bigInteger",
+        type: "date",
         nullable: true,
-        desc: "차단 만료 (Unix timestamp)",
+        desc: "차단 만료",
       },
     ],
     Session: [

package/src/auth/plugins/entity-definitions/audit-log.ts

@@ -3,8 +3,8 @@ import { type BetterAuthEntityDef } from "./types";
 /**
  * better-auth AuditLog 플러그인 엔티티 정의
  *
- * auth.auditLog: true 로 활성화되며 audit_events 테이블을 생성합니다.
- * - Better Auth dash() 플러그인이 전송하는 이벤트를 1건씩 적재합니다.
+ * auth.plugins에 sonamuAuditLog() 추가 시 audit_events 테이블이 사용됩니다.
+ * - sonamuAuditLog 플러그인이 Better Auth databaseHooks/organizationHooks/middleware에서 수신한 이벤트를 1건씩 적재합니다.
  * - dedupe_key(sha256 hex)로 중복 적재를 방지합니다.
  *
  * 생성 방법: pnpm sonamu auth generate --plugins audit-log

package/src/bin/fixture.ts

@@ -22,6 +22,23 @@ interface FixtureCommandOptions {
   "no-cache"?: boolean;
 }
 
+/**
+ * username을 일반적인 규칙(영문자 시작, 영문자/숫자만, 1-20자)에 맞도록 정규화합니다.
+ */
+function sanitizeUsername(raw: string): string {
+  // 소문자 변환 후 영문자/숫자 외 문자 제거
+  let username = raw.toLowerCase().replace(/[^a-z0-9]/g, "");
+  if (username.length === 0) {
+    username = "user";
+  }
+  // 첫 글자가 숫자면 'u' 접두어 추가
+  if (/^[0-9]/.test(username)) {
+    username = `u${username}`;
+  }
+  // 20자 초과 시 truncate
+  return username.slice(0, 20);
+}
+
 /**
  * fixture gen 명령어 - cone 메타데이터를 활용하여 자동으로 fixture를 생성합니다.
  */
@@ -76,6 +93,132 @@ export async function fixtureGenCommand(options: FixtureCommandOptions) {
       count = result.count;
     }
 
+    // User 엔티티가 포함된 경우: 로그인 가능/확인용 분기 선택
+    const hasUser = entityNames.includes("User");
+
+    if (hasUser) {
+      const userModeResult = await prompts({
+        type: "select",
+        name: "userMode",
+        message: "User 엔티티가 포함되어 있습니다. 생성 방식을 선택하세요:",
+        choices: [
+          { title: "1. 로그인 가능한 사용자 fixture 생성", value: "login" },
+          { title: "2. 확인용 데이터(로그인 불가) 생성", value: "dummy" },
+        ],
+      });
+
+      if (!userModeResult.userMode) {
+        console.log(chalk.yellow("취소되었습니다."));
+        return;
+      }
+
+      if (userModeResult.userMode === "login") {
+        // LLM 사용 여부
+        let useLLM = options["use-llm"] ?? false;
+        if (!options["use-llm"]) {
+          const llmResult = await prompts({
+            type: "confirm",
+            name: "useLLM",
+            message:
+              "LLM으로 더 현실적인 데이터를 생성할까요? (fixtureHint 기반, ANTHROPIC_API_KEY 필요)",
+            initial: false,
+          });
+          useLLM = llmResult.useLLM ?? false;
+        }
+
+        const enableLLMCache = !options["no-cache"];
+        const DEFAULT_PASSWORD = "Test1234!";
+
+        // 로그인 가능 경로에서는 sourceDb로 development_master 사용
+        const sourceDb = DB.getDB("r");
+        const generator = new FixtureGenerator(
+          sourceDb,
+          sourceDb,
+          "production_master",
+          EntityManager,
+          { useLLM, enableLLMCache },
+        );
+
+        const createdCredentials: Array<{ email: string; password: string }> = [];
+        const basePath = Sonamu.config.server.auth?.basePath ?? "/api/auth";
+
+        if (useLLM) {
+          console.log(
+            chalk.cyan(
+              `\nLLM 모드로 로그인 가능한 사용자 ${count}명 생성 중... (캐싱: ${enableLLMCache ? "ON" : "OFF"})`,
+            ),
+          );
+        } else {
+          console.log(chalk.cyan(`\n로그인 가능한 사용자 ${count}명 생성 중...`));
+        }
+
+        for (let i = 0; i < count; i++) {
+          const userData = await generator.generate("User");
+
+          const name = String(userData.name ?? "");
+          const email = String(userData.email ?? "");
+          const username = sanitizeUsername(String(userData.username ?? ""));
+          const displayUsername =
+            userData.display_username !== undefined ? String(userData.display_username) : undefined;
+
+          const body: Record<string, unknown> = {
+            name,
+            email,
+            username,
+            password: DEFAULT_PASSWORD,
+          };
+          if (displayUsername !== undefined) {
+            body.display_username = displayUsername;
+          }
+
+          const req = new Request(`http://localhost${basePath}/sign-up/email`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(body),
+          });
+
+          const response = await Sonamu.auth.handler(req);
+
+          if (!response.ok) {
+            const responseData = (await response.json()) as Record<string, unknown>;
+            const code = typeof responseData.code === "string" ? responseData.code : undefined;
+            if (code === "USER_ALREADY_EXISTS") {
+              console.log(chalk.yellow(`  ⚠️  ${email} 이미 존재 - 건너뜁니다.`));
+              continue;
+            }
+            console.log(chalk.red(`  ❌ ${email} 생성 실패: ${JSON.stringify(responseData)}`));
+            continue;
+          }
+
+          createdCredentials.push({ email, password: DEFAULT_PASSWORD });
+          console.log(chalk.green(`  ✅ ${email} 생성 완료`));
+        }
+
+        // email_verified = true 직접 업데이트 (dev 편의)
+        if (createdCredentials.length > 0) {
+          const emails = createdCredentials.map((c) => c.email);
+          await DB.getDB("w")("users").whereIn("email", emails).update({ email_verified: true });
+          console.log(chalk.green(`\nemail_verified = true 업데이트 완료`));
+        }
+
+        if (useLLM) {
+          const stats = generator.getLLMCacheStats();
+          console.log(chalk.cyan(`[LLM Cache] 캐시 크기: ${stats.size}`));
+        }
+
+        console.log(
+          chalk.green(`\n✅ ${createdCredentials.length}명의 로그인 가능한 사용자 생성 완료`),
+        );
+        if (createdCredentials.length > 0) {
+          console.log("\n생성된 계정 목록:");
+          console.table(createdCredentials);
+        }
+
+        return;
+      }
+      // userMode === "dummy": 기존 generateBatch() 흐름 계속
+    }
+
     let saveTarget = options["save-to"] || "db";
     if (!options["save-to"]) {
       const result = await prompts({

package/src/database/_batch_update.ts

@@ -15,7 +15,7 @@ export type RowWithId<Id extends string> = {
 
 /**
  * Batch update rows in a table. Technically its a patch since it only updates the specified columns. Any omitted columns will not be affected
- * @param db
+ * @param knex
  * @param tableName
  * @param ids
  * @param rows

package/src/database/upsert-builder.ts

@@ -310,7 +310,7 @@ export class UpsertBuilder {
 
         // uuid를 별도로 보관하고, DB에 저장할 데이터에서 제거
         const originalUuids = dataChunk.map((r) => r.uuid as string);
-        const dataForDb = dataChunk.map(({ uuid, ...rest }) => rest);
+        const dataForDb = dataChunk.map(({ uuid: _, ...rest }) => rest);
 
         let resultRows: { id: number | string; [key: string]: unknown }[];
 
@@ -331,7 +331,7 @@ export class UpsertBuilder {
               for (const row of rowsWithoutId) {
                 const values = columns.map((col) => row[col]);
                 // null이 포함된 조건은 제외 (PostgreSQL UNIQUE는 NULL 무시)
-                if (!values.some((v) => v == null)) {
+                if (!values.some((v) => v === null || v === undefined)) {
                   conditions.push(values);
                 }
               }
@@ -448,7 +448,7 @@ export class UpsertBuilder {
 
       // 현재 register된 레코드들의 FK 값들 추출
       const fkConditions = fkColumns.map((fkCol) => {
-        const fkValues = [...new Set(table.rows.map((row) => row[fkCol]).filter((v) => v != null))];
+        const fkValues = [...new Set(table.rows.map((row) => row[fkCol]).filter(Boolean))];
         return { column: fkCol, values: fkValues };
       });
 

package/src/dict/sonamu-dictionary.ts

@@ -631,7 +631,7 @@ export class SonamuDictionary {
     const stats: Record<string, { total: number; filled: number; percent: number }> = {};
     const total = rows.length;
     for (const locale of locales) {
-      const filled = rows.filter((row) => row[locale] != null && row[locale] !== "").length;
+      const filled = rows.filter((row) => !!row[locale]).length;
       const percent = total > 0 ? Math.round((filled / total) * 100) : 0;
       stats[locale] = { total, filled, percent };
     }

package/src/entity/entity-manager.ts

@@ -267,9 +267,16 @@ class EntityManagerClass {
    * @returns
    */
   getEntityIdFromPath(filePath: AbsolutePath): string {
-    const matched = filePath.match(/application\/(.+)\//);
-    assert(matched?.[1]);
-    return inflection.camelize(matched[1].replace(/-/g, "_"));
+    const fileName = path.basename(filePath);
+    const supportedSuffixes = [".model.ts", ".model.js", ".entity.json", ".frame.ts", ".frame.js"];
+    const matchedSuffix = supportedSuffixes.find((suffix) => fileName.endsWith(suffix));
+
+    assert(matchedSuffix, `지원하지 않는 entity 경로입니다: ${filePath}`);
+
+    const entityBaseName = fileName.slice(0, -matchedSuffix.length);
+    assert(entityBaseName.length > 0, `EntityId를 계산할 수 없는 경로입니다: ${filePath}`);
+
+    return inflection.camelize(entityBaseName.replace(/-/g, "_"));
   }
 
   private async registerNonEntityTypeModulePaths(): Promise<void> {

package/src/migration/code-generation.ts

@@ -871,12 +871,7 @@ function genNormalColumnDefinition(column: MigrationColumn): string {
     chains.push(`jsonb('${column.name}')`);
   } else {
     // type, length
-    let extraType: string | undefined;
-    chains.push(
-      `${column.type}('${column.name}'${
-        column.length ? `, ${column.length}` : ""
-      }${extraType ? `, '${extraType}'` : ""})`,
-    );
+    chains.push(`${column.type}('${column.name}'${column.length ? `, ${column.length}` : ""})`);
   }
 
   // nullable

package/src/shared/app.shared.ts.txt

@@ -3,8 +3,8 @@
  * 최초 1회 생성되며, 이후에는 덮어쓰지 않습니다.
  * 필요시 직접 수정할 수 있습니다.
  */
+
 /* oxlint-disable react-hooks/exhaustive-deps */ // shared
-/* oxlint-disable @typescript-eslint/no-explicit-any */ // shared
 
 /*
   fetch
@@ -12,12 +12,12 @@
 import type { AxiosRequestConfig } from "axios";
 import axios from "axios";
 import qs from "qs";
-import { useEffect, useRef, useState } from "react";
+import { useCallback, useEffect, useRef, useState } from "react";
 import { Alert } from "react-native";
 import { type core, z } from "zod";
-import { getCurrentLocale } from "~/i18n/sd.generated";
+import { type InfiniteData } from "@tanstack/react-query";
+import { getCurrentLocale } from "@/i18n/sd.generated";
 import { ExpoEventSource as EventSource } from "@falcondev-oss/expo-event-source-polyfill";
-import { getCurrentLocale } from "../i18n/sd.generated"
 
 // AbortSignal.timeout polyfill for React Native
 if (typeof AbortSignal !== "undefined" && !AbortSignal.timeout) {
@@ -511,7 +511,7 @@ export function useSSEStream<T extends Record<string, any>>(
             }
 
             try {
-              const data = JSON.parse(event.data as string);
+              const data = JSON.parse(event.data as string, dateReviver);
               handler(data);
             } catch (error) {
               console.error(`Failed to parse SSE data for event ${eventType}:`, error);
@@ -532,7 +532,7 @@ export function useSSEStream<T extends Record<string, any>>(
         }
 
         try {
-          const data = JSON.parse(event.data as string);
+          const data = JSON.parse(event.data as string, dateReviver);
           // 'message' 핸들러가 있으면 호출
           const messageHandler = handlersRef.current["message" as keyof T];
           if (messageHandler) {
@@ -585,3 +585,57 @@ export function useSSEStream<T extends Record<string, any>>(
   Dictionary Helper
 */
 $[[dictUtils]]
+/*
+  Query helpers
+*/
+type InfinitePage<TRow> = { rows: TRow[]; total: number };
+type DedupedInfiniteData<TRow> = InfiniteData<InfinitePage<TRow>> & {
+  rows: TRow[];
+  total: number;
+};
+
+// useInfiniteQuery의 select에 꽂아 pages/pageParams 원본은 유지하면서
+// 평탄화된 rows와 첫 페이지의 total을 data에 함께 노출합니다.
+// 각 row가 id를 갖는 경우 id 기준으로 중복 제거합니다. id가 없으면 그대로 유지합니다.
+export function dedupeAndFlatten<TRow extends { id?: unknown }>(
+  data: InfiniteData<InfinitePage<TRow>>,
+): DedupedInfiniteData<TRow> {
+  const seen = new Set<unknown>();
+  const rows: TRow[] = [];
+  for (const page of data.pages) {
+    for (const row of page?.rows ?? []) {
+      const id = row?.id;
+      if (id !== null) {
+        if (seen.has(id)) {
+          continue;
+        }
+        seen.add(id);
+      }
+      rows.push(row);
+    }
+  }
+  const total = data.pages[0]?.total ?? 0;
+  return {
+    pages: data.pages,
+    pageParams: data.pageParams,
+    rows,
+    total,
+  };
+}
+
+// TanStack Query 결과에 수동 refresh 진입점과 새로고침 중 상태를 덧붙여 줍니다.
+// isRefreshing은 query.isFetching과 독립적으로 이 함수 호출로 발생한 새로고침에 한정됩니다.
+export function useRefreshable<T extends { refetch: () => Promise<unknown> }>(
+  query: T,
+): T & { refresh: () => Promise<void>; isRefreshing: boolean } {
+  const [isRefreshing, setIsRefreshing] = useState(false);
+  const refresh = useCallback(async () => {
+    setIsRefreshing(true);
+    try {
+      await query.refetch();
+    } finally {
+      setIsRefreshing(false);
+    }
+  }, [query]);
+  return { ...query, refresh, isRefreshing };
+}

package/src/shared/web.shared.ts.txt

@@ -3,8 +3,8 @@
  * 최초 1회 생성되며, 이후에는 덮어쓰지 않습니다.
  * 필요시 직접 수정할 수 있습니다.
  */
+
 /* oxlint-disable react-hooks/exhaustive-deps */ // shared
-/* oxlint-disable @typescript-eslint/no-explicit-any */ // shared
 
 /*
   fetch
@@ -13,9 +13,10 @@ import type { AxiosRequestConfig } from "axios";
 import axios from "axios";
 import { EventSource } from "eventsource";
 import qs from "qs";
-import { useEffect, useRef, useState } from "react";
+import { useCallback, useEffect, useRef, useState } from "react";
 import { type core, z } from "zod";
-import { getCurrentLocale } from "../i18n/sd.generated";
+import { type InfiniteData } from "@tanstack/react-query";
+import { getCurrentLocale } from "@/i18n/sd.generated";
 
 // ISO 8601 및 타임존 포맷의 날짜 문자열을 Date 객체로 변환하는 reviver
 export function dateReviver(_key: string, value: any): any {
@@ -480,7 +481,7 @@ export function useSSEStream<T extends Record<string, any>>(
             }
 
             try {
-              const data = JSON.parse(event.data);
+              const data = JSON.parse(event.data, dateReviver);
               handler(data);
             } catch (error) {
               console.error(`Failed to parse SSE data for event ${eventType}:`, error);
@@ -501,7 +502,7 @@ export function useSSEStream<T extends Record<string, any>>(
         }
 
         try {
-          const data = JSON.parse(event.data);
+          const data = JSON.parse(event.data, dateReviver);
           // 'message' 핸들러가 있으면 호출
           const messageHandler = handlersRef.current["message" as keyof T];
           if (messageHandler) {
@@ -554,3 +555,57 @@ export function useSSEStream<T extends Record<string, any>>(
   Dictionary Helper
 */
 $[[dictUtils]]
+/*
+  Query helpers
+*/
+type InfinitePage<TRow> = { rows: TRow[]; total: number };
+type DedupedInfiniteData<TRow> = InfiniteData<InfinitePage<TRow>> & {
+  rows: TRow[];
+  total: number;
+};
+
+// useInfiniteQuery의 select에 꽂아 pages/pageParams 원본은 유지하면서
+// 평탄화된 rows와 첫 페이지의 total을 data에 함께 노출합니다.
+// 각 row가 id를 갖는 경우 id 기준으로 중복 제거합니다. id가 없으면 그대로 유지합니다.
+export function dedupeAndFlatten<TRow extends { id?: unknown }>(
+  data: InfiniteData<InfinitePage<TRow>>,
+): DedupedInfiniteData<TRow> {
+  const seen = new Set<unknown>();
+  const rows: TRow[] = [];
+  for (const page of data.pages) {
+    for (const row of page?.rows ?? []) {
+      const id = row?.id;
+      if (id !== null) {
+        if (seen.has(id)) {
+          continue;
+        }
+        seen.add(id);
+      }
+      rows.push(row);
+    }
+  }
+  const total = data.pages[0]?.total ?? 0;
+  return {
+    pages: data.pages,
+    pageParams: data.pageParams,
+    rows,
+    total,
+  };
+}
+
+// TanStack Query 결과에 수동 refresh 진입점과 새로고침 중 상태를 덧붙여 줍니다.
+// isRefreshing은 query.isFetching과 독립적으로 이 함수 호출로 발생한 새로고침에 한정됩니다.
+export function useRefreshable<T extends { refetch: () => Promise<unknown> }>(
+  query: T,
+): T & { refresh: () => Promise<void>; isRefreshing: boolean } {
+  const [isRefreshing, setIsRefreshing] = useState(false);
+  const refresh = useCallback(async () => {
+    setIsRefreshing(true);
+    try {
+      await query.refetch();
+    } finally {
+      setIsRefreshing(false);
+    }
+  }, [query]);
+  return { ...query, refresh, isRefreshing };
+}

package/src/syncer/syncer.ts

@@ -5,7 +5,6 @@ import path from "path";
 
 import { hot } from "@sonamu-kit/hmr-hook";
 import chalk from "chalk";
-import inflection from "inflection";
 import { minimatch } from "minimatch";
 import { group, unique } from "radashi";
 import { type z } from "zod";
@@ -452,22 +451,13 @@ export class Syncer {
     const params: {
       namesRecord: EntityNamesRecord;
     }[] = mergedGroup.map((modelPath) => {
-      if (modelPath.endsWith(".model.ts")) {
+      if (modelPath.endsWith(".model.ts") || modelPath.endsWith(".frame.ts")) {
         const entityId = EntityManager.getEntityIdFromPath(modelPath);
         assert(entityId);
         return {
           namesRecord: EntityManager.getNamesFromId(entityId),
         };
       }
-      if (modelPath.endsWith(".frame.ts")) {
-        const [, frameName] = modelPath.match(/.+\/(.+)\.frame\.ts$/) ?? [];
-        assert(frameName);
-        // frameName을 PascalCase로 변환 (dashboard -> Dashboard)
-        const frameId = inflection.camelize(frameName);
-        return {
-          namesRecord: EntityManager.getNamesFromId(frameId),
-        };
-      }
       throw new Error("not reachable");
     });
 

package/src/template/implementations/entry-server.template.ts

@@ -75,7 +75,7 @@ export async function render(url: string, preloadedData: PreloadedData[] = []) {
       ...this.getTargetAndPath(),
       body,
       importKeys: [],
-      customHeaders: ["/**", " * @generated", " * 직접 수정하지 마세요.", " */"],
+      customHeaders: ["/**", " * @generated", " * 직접 수정하지 마세요.", " */", ""],
     };
   }
 }

package/src/template/implementations/generated.template.ts

@@ -130,6 +130,7 @@ export class Template__generated extends Template {
         " * @generated",
         " * 직접 수정하지 마세요.",
         " */",
+        "",
         "/* oxlint-disable */",
         "",
         `import { z } from 'zod';`,

package/src/template/implementations/generated_sso.template.ts

@@ -152,6 +152,7 @@ export class Template__generated_sso extends Template {
       " * @generated",
       " * 직접 수정하지 마세요.",
       " */",
+      "",
       `import { ${sonamuImports} } from "sonamu";`,
     ];
     if (this.hasAuthConfig()) {

package/src/template/implementations/queries.template.ts

@@ -106,6 +106,7 @@ ${functions.join("\n\n")}
             " * @generated",
             " * 직접 수정하지 마세요.",
             " */",
+            "",
             "/* oxlint-disable */",
             "",
             `import type { SSRQuery } from 'sonamu/ssr';`,
@@ -116,7 +117,15 @@ ${functions.join("\n\n")}
             `}`,
             "",
           ]
-        : ["/**", " * @generated", " * 직접 수정하지 마세요.", " */", "/* oxlint-disable */", ""],
+        : [
+            "/**",
+            " * @generated",
+            " * 직접 수정하지 마세요.",
+            " */",
+            "",
+            "/* oxlint-disable */",
+            "",
+          ],
     };
   }
 }

package/src/template/implementations/sd.template.ts

@@ -250,7 +250,7 @@ SD.enumLabels = (enumName: string): Record<string, LocalizedString> => {
       ...this.getTargetAndPath(undefined, target),
       body,
       importKeys: [],
-      customHeaders: ["/**", " * @generated", " * 직접 수정하지 마세요.", " */"],
+      customHeaders: ["/**", " * @generated", " * 직접 수정하지 마세요.", " */", ""],
     };
   }