sonamu 0.7.53 → 0.8.0

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

@@ -0,0 +1,215 @@
+import type { BetterAuthEntityDef } from "./types";
+
+/**
+ * better-auth Organization 플러그인 엔티티 정의
+ * https://www.better-auth.com/docs/plugins/organization
+ *
+ * 조직, 멤버, 초대, 팀 관리를 지원합니다.
+ */
+export const organizationEntityDef: BetterAuthEntityDef = {
+  id: "organization",
+  name: "Organization",
+  // 엔티티 순서: 의존관계에 따라 정렬 (Organization → Team → Member → Invitation → TeamMember)
+  entities: [
+    {
+      id: "Organization",
+      table: "organizations",
+      title: "조직",
+      props: [
+        { name: "id", type: "string", desc: "ID" },
+        { name: "name", type: "string", desc: "조직명" },
+        { name: "slug", type: "string", desc: "슬러그" },
+        { name: "logo", type: "string", nullable: true, desc: "로고 URL" },
+        { name: "metadata", type: "string", nullable: true, desc: "메타데이터 (JSON)" },
+        { name: "created_at", type: "date", dbDefault: "CURRENT_TIMESTAMP", desc: "생성일시" },
+      ],
+      indexes: [{ type: "unique", name: "organizations_slug_unique", columns: [{ name: "slug" }] }],
+      subsets: {
+        A: ["id", "name", "slug", "logo", "metadata", "created_at"],
+      },
+      enums: {
+        OrganizationOrderBy: { "id-desc": "ID최신순", "created_at-desc": "생성일최신순" },
+        OrganizationSearchField: { id: "ID", name: "조직명", slug: "슬러그" },
+      },
+    },
+    {
+      id: "Team",
+      table: "teams",
+      title: "팀",
+      props: [
+        { name: "id", type: "string", desc: "ID" },
+        { name: "name", type: "string", desc: "팀명" },
+        { name: "created_at", type: "date", dbDefault: "CURRENT_TIMESTAMP", desc: "생성일시" },
+        { name: "updated_at", type: "date", nullable: true, desc: "수정일시" },
+        {
+          type: "relation",
+          name: "organization",
+          with: "Organization",
+          relationType: "BelongsToOne",
+          onDelete: "CASCADE",
+          desc: "조직",
+        },
+      ],
+      indexes: [
+        {
+          type: "index",
+          name: "teams_organization_id_idx",
+          columns: [{ name: "organization_id" }],
+        },
+      ],
+      subsets: {
+        A: ["id", "name", "created_at", "updated_at", "organization.id"],
+      },
+      enums: {
+        TeamOrderBy: { "id-desc": "ID최신순", "created_at-desc": "생성일최신순" },
+        TeamSearchField: { id: "ID", name: "팀명" },
+      },
+    },
+    {
+      id: "Member",
+      table: "members",
+      title: "멤버",
+      props: [
+        { name: "id", type: "string", desc: "ID" },
+        { name: "role", type: "string", desc: "역할" },
+        { name: "created_at", type: "date", dbDefault: "CURRENT_TIMESTAMP", desc: "생성일시" },
+        {
+          type: "relation",
+          name: "user",
+          with: "User",
+          relationType: "BelongsToOne",
+          onDelete: "CASCADE",
+          desc: "사용자",
+        },
+        {
+          type: "relation",
+          name: "organization",
+          with: "Organization",
+          relationType: "BelongsToOne",
+          onDelete: "CASCADE",
+          desc: "조직",
+        },
+      ],
+      indexes: [
+        { type: "index", name: "members_user_id_idx", columns: [{ name: "user_id" }] },
+        {
+          type: "index",
+          name: "members_organization_id_idx",
+          columns: [{ name: "organization_id" }],
+        },
+      ],
+      subsets: {
+        A: ["id", "role", "created_at", "user.id", "organization.id"],
+      },
+      enums: {
+        MemberOrderBy: { "id-desc": "ID최신순", "created_at-desc": "생성일최신순" },
+        MemberSearchField: { id: "ID", role: "역할" },
+      },
+    },
+    {
+      id: "Invitation",
+      table: "invitations",
+      title: "초대",
+      props: [
+        { name: "id", type: "string", desc: "ID" },
+        { name: "email", type: "string", desc: "이메일" },
+        { name: "role", type: "string", desc: "역할" },
+        { name: "status", type: "string", desc: "상태" },
+        { name: "expires_at", type: "date", desc: "만료일시" },
+        { name: "created_at", type: "date", dbDefault: "CURRENT_TIMESTAMP", desc: "생성일시" },
+        {
+          type: "relation",
+          name: "inviter",
+          with: "User",
+          relationType: "BelongsToOne",
+          onDelete: "CASCADE",
+          desc: "초대자",
+        },
+        {
+          type: "relation",
+          name: "organization",
+          with: "Organization",
+          relationType: "BelongsToOne",
+          onDelete: "CASCADE",
+          desc: "조직",
+        },
+        {
+          type: "relation",
+          name: "team",
+          with: "Team",
+          relationType: "BelongsToOne",
+          onDelete: "SET NULL",
+          nullable: true,
+          desc: "팀",
+        },
+      ],
+      indexes: [
+        { type: "index", name: "invitations_email_idx", columns: [{ name: "email" }] },
+        {
+          type: "index",
+          name: "invitations_organization_id_idx",
+          columns: [{ name: "organization_id" }],
+        },
+      ],
+      subsets: {
+        A: [
+          "id",
+          "email",
+          "role",
+          "status",
+          "expires_at",
+          "created_at",
+          "inviter.id",
+          "organization.id",
+          "team.id",
+        ],
+      },
+      enums: {
+        InvitationOrderBy: { "id-desc": "ID최신순", "created_at-desc": "생성일최신순" },
+        InvitationSearchField: { id: "ID", email: "이메일" },
+      },
+    },
+    {
+      id: "TeamMember",
+      table: "team_members",
+      title: "팀멤버",
+      props: [
+        { name: "id", type: "string", desc: "ID" },
+        { name: "created_at", type: "date", dbDefault: "CURRENT_TIMESTAMP", desc: "생성일시" },
+        {
+          type: "relation",
+          name: "team",
+          with: "Team",
+          relationType: "BelongsToOne",
+          onDelete: "CASCADE",
+          desc: "팀",
+        },
+        {
+          type: "relation",
+          name: "user",
+          with: "User",
+          relationType: "BelongsToOne",
+          onDelete: "CASCADE",
+          desc: "사용자",
+        },
+      ],
+      indexes: [
+        { type: "index", name: "team_members_team_id_idx", columns: [{ name: "team_id" }] },
+        { type: "index", name: "team_members_user_id_idx", columns: [{ name: "user_id" }] },
+      ],
+      subsets: {
+        A: ["id", "created_at", "team.id", "user.id"],
+      },
+      enums: {
+        TeamMemberOrderBy: { "id-desc": "ID최신순", "created_at-desc": "생성일최신순" },
+        TeamMemberSearchField: { id: "ID" },
+      },
+    },
+  ],
+  additionalProps: {
+    Session: [
+      { name: "active_organization_id", type: "string", nullable: true, desc: "활성 조직 ID" },
+      { name: "active_team_id", type: "string", nullable: true, desc: "활성 팀 ID" },
+    ],
+  },
+};

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

@@ -0,0 +1,64 @@
+import type { BetterAuthEntityDef } from "./types";
+
+/**
+ * better-auth Passkey 플러그인 엔티티 정의
+ * https://www.better-auth.com/docs/plugins/passkey
+ *
+ * WebAuthn/FIDO2 기반 패스키 인증을 지원합니다.
+ * Passkey 테이블을 생성하여 사용자의 패스키 정보를 저장합니다.
+ */
+export const passkeyEntityDef: BetterAuthEntityDef = {
+  id: "passkey",
+  name: "Passkey",
+  entities: [
+    {
+      id: "Passkey",
+      table: "passkeys",
+      title: "패스키",
+      props: [
+        { name: "id", type: "string", desc: "ID" },
+        { name: "name", type: "string", nullable: true, desc: "패스키 이름" },
+        { name: "public_key", type: "string", desc: "공개키" },
+        { name: "credential_id", type: "string", desc: "자격 증명 ID" },
+        { name: "counter", type: "integer", desc: "카운터" },
+        { name: "device_type", type: "string", desc: "장치 유형" },
+        { name: "backed_up", type: "boolean", desc: "백업 여부" },
+        { name: "transports", type: "string", nullable: true, desc: "전송 방식" },
+        { name: "aaguid", type: "string", nullable: true, desc: "AAGUID" },
+        { name: "created_at", type: "date", dbDefault: "CURRENT_TIMESTAMP", desc: "생성일시" },
+        {
+          type: "relation",
+          name: "user",
+          with: "User",
+          relationType: "BelongsToOne",
+          onDelete: "CASCADE",
+          desc: "사용자",
+        },
+      ],
+      indexes: [
+        { type: "index", name: "passkeys_user_id_idx", columns: [{ name: "user_id" }] },
+        { type: "index", name: "passkeys_credential_id_idx", columns: [{ name: "credential_id" }] },
+      ],
+      subsets: {
+        A: [
+          "id",
+          "name",
+          "public_key",
+          "credential_id",
+          "counter",
+          "device_type",
+          "backed_up",
+          "transports",
+          "aaguid",
+          "created_at",
+          "user.id",
+        ],
+      },
+      enums: {
+        PasskeyOrderBy: { "id-desc": "ID최신순", "created_at-desc": "생성일최신순" },
+        PasskeySearchField: { id: "ID", name: "이름" },
+      },
+    },
+  ],
+  additionalProps: {},
+};

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

@@ -0,0 +1,62 @@
+import type { BetterAuthEntityDef } from "./types";
+
+/**
+ * better-auth SSO 플러그인 엔티티 정의
+ * https://www.better-auth.com/docs/plugins/sso
+ *
+ * 외부 IdP(OIDC, SAML)를 통한 SSO 로그인을 지원합니다.
+ * SsoProvider 테이블을 생성하여 SSO 제공자 설정을 저장합니다.
+ */
+export const ssoEntityDef: BetterAuthEntityDef = {
+  id: "sso",
+  name: "SSO",
+  entities: [
+    {
+      id: "SsoProvider",
+      table: "sso_providers",
+      title: "SSO 제공자",
+      props: [
+        { name: "id", type: "string", desc: "ID" },
+        { name: "created_at", type: "date", dbDefault: "CURRENT_TIMESTAMP", desc: "생성일시" },
+        { name: "issuer", type: "string", desc: "발급자 URL" },
+        { name: "oidc_config", type: "string", nullable: true, desc: "OIDC 설정 (JSON)" },
+        { name: "saml_config", type: "string", nullable: true, desc: "SAML 설정 (JSON)" },
+        { name: "provider_id", type: "string", desc: "제공자 ID" },
+        { name: "domain", type: "string", nullable: true, desc: "도메인" },
+        {
+          type: "relation",
+          name: "user",
+          with: "User",
+          relationType: "BelongsToOne",
+          onDelete: "CASCADE",
+          desc: "생성자",
+        },
+      ],
+      indexes: [
+        {
+          type: "unique",
+          name: "sso_providers_provider_id_unique",
+          columns: [{ name: "provider_id" }],
+        },
+        { type: "index", name: "sso_providers_user_id_idx", columns: [{ name: "user_id" }] },
+      ],
+      subsets: {
+        A: [
+          "id",
+          "issuer",
+          "oidc_config",
+          "saml_config",
+          "provider_id",
+          "domain",
+          "created_at",
+          "user.id",
+        ],
+      },
+      enums: {
+        SsoProviderOrderBy: { "id-desc": "ID최신순" },
+        SsoProviderSearchField: { id: "ID", provider_id: "제공자ID" },
+      },
+    },
+  ],
+  additionalProps: {},
+};

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

@@ -4,7 +4,17 @@ import type { EntityIndex, EntityJson, EntityProp } from "../../../types/types";
  * better-auth 플러그인 ID
  * 지원하는 플러그인 목록을 정의합니다.
  */
-export type BetterAuthPluginId = "phone-number" | "2fa" | "username" | "admin";
+export type BetterAuthPluginId =
+  | "phone-number"
+  | "2fa"
+  | "username"
+  | "admin"
+  | "sso"
+  | "passkey"
+  | "organization"
+  | "api-key"
+  | "jwt"
+  | "anonymous";
 
 /**
  * better-auth 엔티티 정의

package/src/auth/plugins/wrappers/admin.ts

@@ -33,8 +33,6 @@ export const ADMIN_SCHEMA: AdminOptions["schema"] = {
  * Sonamu의 스키마 매핑을 자동으로 병합합니다.
  */
 export const admin = (options: AdminOptions = {}) => {
-  if (options.schema) {
-    options.schema = merge(ADMIN_SCHEMA, options.schema);
-  }
+  options.schema = merge(ADMIN_SCHEMA, options.schema ?? {});
   return _admin(options);
 };

package/src/auth/plugins/wrappers/anonymous.ts

@@ -0,0 +1,30 @@
+import { anonymous as _anonymous, type AnonymousOptions } from "better-auth/plugins";
+import { merge } from "../../../utils/utils";
+
+export type { AnonymousOptions } from "better-auth/plugins";
+
+/**
+ * Anonymous 플러그인 스키마
+ *
+ * better-auth anonymous 플러그인 호출 시 전달합니다:
+ * ```typescript
+ * anonymous({ schema: ANONYMOUS_SCHEMA })
+ * ```
+ */
+export const ANONYMOUS_SCHEMA: AnonymousOptions["schema"] = {
+  user: {
+    fields: {
+      isAnonymous: "is_anonymous",
+    },
+  },
+};
+
+/**
+ * anonymous 플러그인 래퍼
+ *
+ * Sonamu의 스키마 매핑을 자동으로 병합합니다.
+ */
+export const anonymous = (options: AnonymousOptions = {}): ReturnType<typeof _anonymous> => {
+  options.schema = merge(ANONYMOUS_SCHEMA, options.schema ?? {});
+  return _anonymous(options);
+};

package/src/auth/plugins/wrappers/api-key.ts

@@ -0,0 +1,42 @@
+import { apiKey as _apiKey, type ApiKeyOptions } from "better-auth/plugins";
+import { merge } from "../../../utils/utils";
+
+export type { ApiKeyOptions } from "better-auth/plugins";
+
+/**
+ * API Key 플러그인 스키마
+ *
+ * better-auth apiKey 플러그인 호출 시 전달합니다:
+ * ```typescript
+ * apiKey({ schema: API_KEY_SCHEMA })
+ * ```
+ */
+export const API_KEY_SCHEMA: ApiKeyOptions["schema"] = {
+  apikey: {
+    modelName: "api_keys",
+    fields: {
+      userId: "user_id",
+      lastRequest: "last_request",
+      requestCount: "request_count",
+      rateLimitEnabled: "rate_limit_enabled",
+      rateLimitTimeWindow: "rate_limit_time_window",
+      rateLimitMax: "rate_limit_max",
+      refillInterval: "refill_interval",
+      refillAmount: "refill_amount",
+      lastRefillAt: "last_refill_at",
+      expiresAt: "expires_at",
+      createdAt: "created_at",
+      updatedAt: "updated_at",
+    },
+  },
+};
+
+/**
+ * apiKey 플러그인 래퍼
+ *
+ * Sonamu의 스키마 매핑을 자동으로 병합합니다.
+ */
+export const apiKey = (options: ApiKeyOptions = {}): ReturnType<typeof _apiKey> => {
+  options.schema = merge(API_KEY_SCHEMA, options.schema ?? {});
+  return _apiKey(options);
+};

package/src/auth/plugins/wrappers/index.ts

@@ -1,4 +1,10 @@
 export { ADMIN_SCHEMA, type AdminOptions, admin } from "./admin";
+export { ANONYMOUS_SCHEMA, type AnonymousOptions, anonymous } from "./anonymous";
+export { API_KEY_SCHEMA, type ApiKeyOptions, apiKey } from "./api-key";
+export { JWT_SCHEMA, type JwtOptions, jwt } from "./jwt";
+export { ORGANIZATION_SCHEMA, type OrganizationOptions, organization } from "./organization";
+export { PASSKEY_SCHEMA, type PasskeyOptions, passkey } from "./passkey";
 export { PHONE_NUMBER_SCHEMA, type PhoneNumberOptions, phoneNumber } from "./phone-number";
+export { SSO_SCHEMA, type SSOOptions, sso } from "./sso";
 export { TWO_FACTOR_SCHEMA, type TwoFactorOptions, twoFactor } from "./two-factor";
 export { USERNAME_SCHEMA, type UsernameOptions, username } from "./username";

package/src/auth/plugins/wrappers/jwt.ts

@@ -0,0 +1,34 @@
+import { jwt as _jwt, type JwtOptions } from "better-auth/plugins";
+import { merge } from "../../../utils/utils";
+
+export type { JwtOptions } from "better-auth/plugins";
+
+/**
+ * JWT 플러그인 스키마
+ *
+ * better-auth jwt 플러그인 호출 시 전달합니다:
+ * ```typescript
+ * jwt({ schema: JWT_SCHEMA })
+ * ```
+ */
+export const JWT_SCHEMA: JwtOptions["schema"] = {
+  jwks: {
+    modelName: "jwks",
+    fields: {
+      publicKey: "public_key",
+      privateKey: "private_key",
+      createdAt: "created_at",
+      expiresAt: "expires_at",
+    },
+  },
+};
+
+/**
+ * jwt 플러그인 래퍼
+ *
+ * Sonamu의 스키마 매핑을 자동으로 병합합니다.
+ */
+export const jwt = (options: JwtOptions = {}): ReturnType<typeof _jwt> => {
+  options.schema = merge(JWT_SCHEMA, options.schema ?? {});
+  return _jwt(options);
+};

package/src/auth/plugins/wrappers/organization.ts

@@ -0,0 +1,73 @@
+import { organization as _organization, type OrganizationOptions } from "better-auth/plugins";
+import { merge } from "../../../utils/utils";
+
+export type { OrganizationOptions } from "better-auth/plugins";
+
+/**
+ * Organization 플러그인 스키마
+ *
+ * better-auth organization 플러그인 호출 시 전달합니다:
+ * ```typescript
+ * organization({ schema: ORGANIZATION_SCHEMA })
+ * ```
+ */
+export const ORGANIZATION_SCHEMA: OrganizationOptions["schema"] = {
+  organization: {
+    modelName: "organizations",
+    fields: {
+      createdAt: "created_at",
+    },
+  },
+  member: {
+    modelName: "members",
+    fields: {
+      userId: "user_id",
+      organizationId: "organization_id",
+      createdAt: "created_at",
+    },
+  },
+  invitation: {
+    modelName: "invitations",
+    fields: {
+      inviterId: "inviter_id",
+      organizationId: "organization_id",
+      teamId: "team_id",
+      expiresAt: "expires_at",
+      createdAt: "created_at",
+    },
+  },
+  team: {
+    modelName: "teams",
+    fields: {
+      organizationId: "organization_id",
+      createdAt: "created_at",
+      updatedAt: "updated_at",
+    },
+  },
+  teamMember: {
+    modelName: "team_members",
+    fields: {
+      teamId: "team_id",
+      userId: "user_id",
+      createdAt: "created_at",
+    },
+  },
+  session: {
+    fields: {
+      activeOrganizationId: "active_organization_id",
+      activeTeamId: "active_team_id",
+    },
+  },
+};
+
+/**
+ * organization 플러그인 래퍼
+ *
+ * Sonamu의 스키마 매핑을 자동으로 병합합니다.
+ */
+export const organization = (
+  options: OrganizationOptions = {},
+): ReturnType<typeof _organization> => {
+  options.schema = merge(ORGANIZATION_SCHEMA, options.schema ?? {});
+  return _organization(options);
+};

package/src/auth/plugins/wrappers/passkey.ts

@@ -0,0 +1,36 @@
+import { passkey as _passkey, type PasskeyOptions } from "@better-auth/passkey";
+import { merge } from "../../../utils/utils";
+
+export type { PasskeyOptions } from "@better-auth/passkey";
+
+/**
+ * Passkey 플러그인 스키마
+ *
+ * better-auth passkey 플러그인 호출 시 전달합니다:
+ * ```typescript
+ * passkey({ schema: PASSKEY_SCHEMA })
+ * ```
+ */
+export const PASSKEY_SCHEMA: PasskeyOptions["schema"] = {
+  passkey: {
+    modelName: "passkeys",
+    fields: {
+      publicKey: "public_key",
+      userId: "user_id",
+      credentialID: "credential_id",
+      deviceType: "device_type",
+      backedUp: "backed_up",
+      createdAt: "created_at",
+    },
+  },
+};
+
+/**
+ * passkey 플러그인 래퍼
+ *
+ * Sonamu의 스키마 매핑을 자동으로 병합합니다.
+ */
+export const passkey = (options: PasskeyOptions = {}): ReturnType<typeof _passkey> => {
+  options.schema = merge(PASSKEY_SCHEMA, options.schema ?? {});
+  return _passkey(options);
+};

package/src/auth/plugins/wrappers/phone-number.ts

@@ -26,8 +26,6 @@ export const PHONE_NUMBER_SCHEMA: PhoneNumberOptions["schema"] = {
  * Sonamu의 스키마 매핑을 자동으로 병합합니다.
  */
 export const phoneNumber = (options: PhoneNumberOptions) => {
-  if (options.schema) {
-    options.schema = merge(PHONE_NUMBER_SCHEMA, options.schema);
-  }
+  options.schema = merge(PHONE_NUMBER_SCHEMA, options.schema ?? {});
   return _phoneNumber(options);
 };

package/src/auth/plugins/wrappers/sso.ts

@@ -0,0 +1,40 @@
+import { sso as _sso, type SSOOptions } from "@better-auth/sso";
+
+export type { SSOOptions } from "@better-auth/sso";
+
+/**
+ * SSO 플러그인 스키마
+ *
+ * better-auth sso 플러그인 호출 시 전달합니다:
+ * ```typescript
+ * sso({ schema: SSO_SCHEMA })
+ * ```
+ */
+export const SSO_SCHEMA: SSOOptions = {
+  modelName: "sso_providers",
+  fields: {
+    oidcConfig: "oidc_config",
+    samlConfig: "saml_config",
+    userId: "user_id",
+    providerId: "provider_id",
+    organizationId: "organization_id",
+  },
+};
+
+/**
+ * sso 플러그인 래퍼
+ *
+ * Sonamu의 스키마 매핑을 자동으로 병합합니다.
+ */
+export const sso = (options: SSOOptions = {}) => {
+  options.modelName = "sso_providers";
+  options.fields = {
+    oidcConfig: "oidc_config",
+    samlConfig: "saml_config",
+    userId: "user_id",
+    providerId: "provider_id",
+    organizationId: "organization_id",
+    ...options.fields,
+  };
+  return _sso(options);
+};

package/src/auth/plugins/wrappers/two-factor.ts

@@ -32,8 +32,6 @@ export const TWO_FACTOR_SCHEMA: TwoFactorOptions["schema"] = {
  * Sonamu의 스키마 매핑을 자동으로 병합합니다.
  */
 export const twoFactor = (options: TwoFactorOptions = {}) => {
-  if (options.schema) {
-    options.schema = merge(TWO_FACTOR_SCHEMA, options.schema);
-  }
+  options.schema = merge(TWO_FACTOR_SCHEMA, options.schema ?? {});
   return _twoFactor(options);
 };

package/src/auth/plugins/wrappers/username.ts

@@ -26,8 +26,6 @@ export const USERNAME_SCHEMA: UsernameOptions["schema"] = {
  * Sonamu의 스키마 매핑을 자동으로 병합합니다.
  */
 export const username = (options: UsernameOptions = {}) => {
-  if (options.schema) {
-    options.schema = merge(USERNAME_SCHEMA, options.schema);
-  }
+  options.schema = merge(USERNAME_SCHEMA, options.schema ?? {});
   return _username(options);
 };