@chuseok22/capacitor-kakao-login 0.1.1

package/CapacitorKakaoLogin.podspec

@@ -0,0 +1,18 @@
+require 'json'
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name         = 'CapacitorKakaoLogin'
+  s.version      = package['version']
+  s.summary      = 'Capacitor plugin for Kakao social login (iOS & Android)'
+  s.homepage     = 'https://github.com/chuseok22/capacitor-kakao-login'
+  s.license      = 'MIT'
+  s.author       = { 'Baek Jihoon' => 'chuseok22@gmail.com' }
+  s.source       = { :git => 'https://github.com/chuseok22/capacitor-kakao-login.git', :tag => s.version.to_s }
+  s.source_files = 'ios/Sources/**/*.swift'
+  s.ios.deployment_target = '13.0'
+  s.swift_version = '5.9'
+  s.dependency 'Capacitor'
+  s.dependency 'KakaoSDKAuth', '~> 2.23'
+  s.dependency 'KakaoSDKUser', '~> 2.23'
+end

package/README.md

@@ -0,0 +1,166 @@
+# @chuseok22/capacitor-kakao-login
+
+Capacitor 앱에서 카카오 소셜 로그인을 `npm install` + `npx cap sync` 만으로 쉽게 사용할 수 있는 플러그인입니다. iOS와 Android 모두 지원합니다.
+
+## 왜 이 패키지가 필요한가
+
+`npx cap sync` 실행 시 Capacitor CLI는 `node_modules/` 내 npm 패키지만 플러그인으로 스캔합니다. 로컬 Swift 파일은 자동으로 `packageClassList`에 등록되지 않아 `UNIMPLEMENTED` 에러가 발생합니다. 이 패키지는 올바른 Capacitor 플러그인 구조를 갖추어 `npx cap sync`만으로 자동 등록되게 합니다.
+
+## 설치
+
+```bash
+npm install @chuseok22/capacitor-kakao-login
+npx cap sync
+```
+
+## 사용법
+
+```typescript
+import { KakaoLogin } from '@chuseok22/capacitor-kakao-login';
+
+try {
+  const { socialId } = await KakaoLogin.login();
+  console.log('카카오 사용자 ID:', socialId);
+} catch (error) {
+  console.error('카카오 로그인 실패:', error);
+}
+```
+
+## iOS 설정
+
+### 1. KakaoSDK 초기화 (`AppDelegate.swift`)
+
+```swift
+import KakaoSDKCommon
+
+func application(_ application: UIApplication,
+    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
+    KakaoSDK.initSDK(appKey: "YOUR_NATIVE_APP_KEY")
+    return true
+}
+```
+
+### 2. URL 핸들러 등록 (`AppDelegate.swift`)
+
+```swift
+import KakaoSDKAuth
+
+func application(_ app: UIApplication, open url: URL,
+    options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
+    if AuthApi.isKakaoTalkLoginUrl(url) {
+        return AuthController.handleOpenUrl(url: url)
+    }
+    return ApplicationDelegateProxy.shared.application(app, open: url, options: options)
+}
+```
+
+### 3. `Info.plist` 설정
+
+카카오톡 앱 연동 및 URL 스킴을 등록합니다.
+
+```xml
+<!-- 카카오톡 앱 링크 허용 -->
+<key>LSApplicationQueriesSchemes</key>
+<array>
+  <string>kakaokompassauth</string>
+  <string>storykompassauth</string>
+  <string>kakaolink</string>
+</array>
+
+<!-- 앱 URL 스킴 등록 (kakao + 네이티브 앱 키) -->
+<key>CFBundleURLTypes</key>
+<array>
+  <dict>
+    <key>CFBundleURLSchemes</key>
+    <array>
+      <string>kakao{NATIVE_APP_KEY}</string>
+    </array>
+  </dict>
+</array>
+```
+
+`{NATIVE_APP_KEY}`를 [카카오 개발자 콘솔](https://developers.kakao.com)의 네이티브 앱 키로 교체하세요.
+
+## Android 설정
+
+### 1. KakaoSDK 초기화 (`Application` 클래스)
+
+`Application` 서브클래스를 생성하고 KakaoSDK를 초기화합니다.
+
+```kotlin
+import com.kakao.sdk.common.KakaoSdk
+
+class MyApplication : Application() {
+    override fun onCreate() {
+        super.onCreate()
+        KakaoSdk.init(this, "YOUR_NATIVE_APP_KEY")
+    }
+}
+```
+
+`AndroidManifest.xml`에 Application 클래스를 등록합니다:
+
+```xml
+<application
+    android:name=".MyApplication"
+    ...>
+```
+
+### 2. `AndroidManifest.xml` — 카카오 로그인 Activity 등록
+
+카카오 계정 웹뷰 로그인 후 앱으로 돌아오기 위한 Activity를 등록합니다.
+
+```xml
+<activity
+    android:name="com.kakao.sdk.auth.AuthCodeHandlerActivity"
+    android:exported="true">
+  <intent-filter>
+    <action android:name="android.intent.action.VIEW" />
+    <category android:name="android.intent.category.DEFAULT" />
+    <category android:name="android.intent.category.BROWSABLE" />
+    <data
+        android:host="oauth"
+        android:scheme="kakao{NATIVE_APP_KEY}" />
+  </intent-filter>
+</activity>
+```
+
+`{NATIVE_APP_KEY}`를 [카카오 개발자 콘솔](https://developers.kakao.com)의 네이티브 앱 키로 교체하세요.
+
+## API
+
+### `login() → Promise<KakaoLoginResult>`
+
+카카오 로그인을 실행합니다.
+
+- 카카오톡 앱이 설치된 경우: 카카오톡 앱을 통한 로그인
+- 미설치 시: 카카오 계정 웹뷰 로그인
+
+**반환값:**
+
+```typescript
+interface KakaoLoginResult {
+  /** 카카오 회원 고유 ID. 서버 사용자 식별에 사용합니다. */
+  socialId: string;
+}
+```
+
+**에러:**
+
+| 에러 메시지 | 원인 |
+|------------|------|
+| `카카오 로그인 실패: ...` | 사용자 취소 또는 카카오 인증 오류 |
+| `사용자 정보 조회 실패: ...` | 카카오 API 호출 오류 |
+| `카카오 사용자 ID를 가져올 수 없습니다` | 예상치 못한 응답 형식 |
+
+## 지원 플랫폼
+
+| 플랫폼 | 지원 |
+|--------|------|
+| iOS | ✅ iOS 13+ |
+| Android | ✅ API 22+ |
+| Web | ❌ 미지원 (네이티브 전용) |
+
+## License
+
+MIT

package/android/build.gradle

@@ -0,0 +1,44 @@
+apply plugin: 'com.android.library'
+apply plugin: 'kotlin-android'
+
+android {
+    namespace "com.capacitorkakaologin"
+    compileSdkVersion project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 34
+    defaultConfig {
+        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 22
+        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 34
+        versionCode 1
+        versionName "1.0"
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+    lint {
+        abortOnError false
+    }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
+    }
+    kotlinOptions {
+        jvmTarget = '17'
+    }
+}
+
+repositories {
+    google()
+    mavenCentral()
+    // Kakao Android SDK — Maven Central에 없으므로 별도 저장소 필수
+    maven { url 'https://devrepo.kakao.com/nexus/content/groups/public/' }
+}
+
+dependencies {
+    implementation fileTree(dir: 'libs', include: ['*.jar'])
+    implementation project(':capacitor-android')
+    // 카카오 로그인 모듈만 포함 (불필요한 모듈 제외)
+    implementation "com.kakao.sdk:v2-user:2.20.6"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,3 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/java/com/capacitorkakaologin/KakaoLoginPlugin.kt

@@ -0,0 +1,56 @@
+package com.capacitorkakaologin
+
+import com.getcapacitor.JSObject
+import com.getcapacitor.Plugin
+import com.getcapacitor.PluginCall
+import com.getcapacitor.PluginMethod
+import com.getcapacitor.annotation.CapacitorPlugin
+import com.kakao.sdk.auth.model.OAuthToken
+import com.kakao.sdk.user.UserApiClient
+
+// name 값은 TypeScript registerPlugin('KakaoLogin', ...) 과 반드시 일치해야 한다
+@CapacitorPlugin(name = "KakaoLogin")
+class KakaoLoginPlugin : Plugin() {
+
+    @PluginMethod
+    fun login(call: PluginCall) {
+        // ApplicationContext 대신 Activity 사용 — startActivity() 호출이 내부적으로 필요하기 때문
+        val activity = activity ?: run {
+            call.reject("Activity를 사용할 수 없습니다")
+            return
+        }
+
+        // OAuthToken 콜백 — 앱/계정 로그인 공통 처리
+        val callback: (OAuthToken?, Throwable?) -> Unit = callback@{ _, error ->
+            if (error != null) {
+                call.reject("카카오 로그인 실패: ${error.message}")
+                return@callback
+            }
+
+            UserApiClient.instance.me { user, meError ->
+                if (meError != null) {
+                    call.reject("사용자 정보 조회 실패: ${meError.message}")
+                    return@me
+                }
+
+                val userId = user?.id
+                if (userId == null) {
+                    call.reject("카카오 사용자 ID를 가져올 수 없습니다")
+                    return@me
+                }
+
+                val result = JSObject()
+                result.put("socialId", userId.toString())
+                call.resolve(result)
+            }
+        }
+
+        if (UserApiClient.instance.isKakaoTalkLoginAvailable(activity)) {
+            // 카카오톡 앱 설치 시 앱 로그인 우선 시도
+            UserApiClient.instance.loginWithKakaoTalk(activity, callback = callback)
+        } else {
+            // 카카오톡 미설치 시 카카오 계정 웹뷰 로그인으로 폴백
+            UserApiClient.instance.loginWithKakaoAccount(activity, callback = callback)
+        }
+    }
+}

package/dist/esm/constants/version.d.ts

@@ -0,0 +1 @@
+export declare const APP_VERSION: string;

package/dist/esm/constants/version.js

@@ -0,0 +1,2 @@
+export const APP_VERSION = '0.1.1';
+//# sourceMappingURL=version.js.map

package/dist/esm/constants/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/constants/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAW,OAAO,CAAC"}

package/dist/esm/definitions.d.ts

@@ -0,0 +1,13 @@
+export interface KakaoLoginPlugin {
+    /**
+     * 카카오 로그인을 실행한다.
+     * - 카카오톡 앱이 설치된 경우: 앱을 통한 로그인
+     * - 미설치 시: 카카오 계정 웹뷰 로그인
+     * @returns 카카오 사용자 고유 ID (socialId)
+     */
+    login(): Promise<KakaoLoginResult>;
+}
+export interface KakaoLoginResult {
+    /** 카카오 회원 고유 ID. 서버에 전달하여 사용자 식별에 사용한다. */
+    socialId: string;
+}

package/dist/esm/definitions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=definitions.js.map

package/dist/esm/definitions.js.map

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

package/dist/esm/index.d.ts

@@ -0,0 +1,4 @@
+import type { KakaoLoginPlugin } from './definitions';
+declare const KakaoLogin: KakaoLoginPlugin;
+export * from './definitions';
+export { KakaoLogin };

package/dist/esm/index.js

@@ -0,0 +1,8 @@
+import { registerPlugin } from '@capacitor/core';
+// 플러그인 등록명은 iOS jsName 및 Android @CapacitorPlugin(name) 과 반드시 일치해야 한다.
+const KakaoLogin = registerPlugin('KakaoLogin', {
+    web: () => import('./web').then(m => new m.KakaoLoginWeb()),
+});
+export * from './definitions';
+export { KakaoLogin };
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,uEAAuE;AACvE,MAAM,UAAU,GAAG,cAAc,CAAmB,YAAY,EAAE;IAChE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;CAC5D,CAAC,CAAC;AAEH,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/esm/web.d.ts

@@ -0,0 +1,5 @@
+import { WebPlugin } from '@capacitor/core';
+import type { KakaoLoginPlugin, KakaoLoginResult } from './definitions';
+export declare class KakaoLoginWeb extends WebPlugin implements KakaoLoginPlugin {
+    login(): Promise<KakaoLoginResult>;
+}

package/dist/esm/web.js

@@ -0,0 +1,8 @@
+import { WebPlugin } from '@capacitor/core';
+// 카카오 로그인은 네이티브 앱 환경 전용이므로, 웹 구현체는 unimplemented 에러를 던진다.
+export class KakaoLoginWeb extends WebPlugin {
+    async login() {
+        throw this.unimplemented('카카오 로그인은 네이티브 앱 환경에서만 지원됩니다.');
+    }
+}
+//# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,0DAA0D;AAC1D,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC1C,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,aAAa,CAAC,8BAA8B,CAAC,CAAC;IAC3D,CAAC;CACF"}

package/dist/plugin.cjs.js

@@ -0,0 +1,23 @@
+'use strict';
+
+var core = require('@capacitor/core');
+
+// 플러그인 등록명은 iOS jsName 및 Android @CapacitorPlugin(name) 과 반드시 일치해야 한다.
+const KakaoLogin = core.registerPlugin('KakaoLogin', {
+    web: () => Promise.resolve().then(function () { return web; }).then(m => new m.KakaoLoginWeb()),
+});
+
+// 카카오 로그인은 네이티브 앱 환경 전용이므로, 웹 구현체는 unimplemented 에러를 던진다.
+class KakaoLoginWeb extends core.WebPlugin {
+    async login() {
+        throw this.unimplemented('카카오 로그인은 네이티브 앱 환경에서만 지원됩니다.');
+    }
+}
+
+var web = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    KakaoLoginWeb: KakaoLoginWeb
+});
+
+exports.KakaoLogin = KakaoLogin;
+//# sourceMappingURL=plugin.cjs.js.map

package/dist/plugin.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\n// 플러그인 등록명은 iOS jsName 및 Android @CapacitorPlugin(name) 과 반드시 일치해야 한다.\nconst KakaoLogin = registerPlugin('KakaoLogin', {\n    web: () => import('./web').then(m => new m.KakaoLoginWeb()),\n});\nexport * from './definitions';\nexport { KakaoLogin };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\n// 카카오 로그인은 네이티브 앱 환경 전용이므로, 웹 구현체는 unimplemented 에러를 던진다.\nexport class KakaoLoginWeb extends WebPlugin {\n    async login() {\n        throw this.unimplemented('카카오 로그인은 네이티브 앱 환경에서만 지원됩니다.');\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AACA;AACK,MAAC,UAAU,GAAGA,mBAAc,CAAC,YAAY,EAAE;AAChD,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;AAC/D,CAAC;;ACHD;AACO,MAAM,aAAa,SAASC,cAAS,CAAC;AAC7C,IAAI,MAAM,KAAK,GAAG;AAClB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,8BAA8B,CAAC;AAChE,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.esm.js

@@ -0,0 +1,21 @@
+import { registerPlugin, WebPlugin } from '@capacitor/core';
+
+// 플러그인 등록명은 iOS jsName 및 Android @CapacitorPlugin(name) 과 반드시 일치해야 한다.
+const KakaoLogin = registerPlugin('KakaoLogin', {
+    web: () => Promise.resolve().then(function () { return web; }).then(m => new m.KakaoLoginWeb()),
+});
+
+// 카카오 로그인은 네이티브 앱 환경 전용이므로, 웹 구현체는 unimplemented 에러를 던진다.
+class KakaoLoginWeb extends WebPlugin {
+    async login() {
+        throw this.unimplemented('카카오 로그인은 네이티브 앱 환경에서만 지원됩니다.');
+    }
+}
+
+var web = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    KakaoLoginWeb: KakaoLoginWeb
+});
+
+export { KakaoLogin };
+//# sourceMappingURL=plugin.esm.js.map

package/dist/plugin.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.esm.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\n// 플러그인 등록명은 iOS jsName 및 Android @CapacitorPlugin(name) 과 반드시 일치해야 한다.\nconst KakaoLogin = registerPlugin('KakaoLogin', {\n    web: () => import('./web').then(m => new m.KakaoLoginWeb()),\n});\nexport * from './definitions';\nexport { KakaoLogin };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\n// 카카오 로그인은 네이티브 앱 환경 전용이므로, 웹 구현체는 unimplemented 에러를 던진다.\nexport class KakaoLoginWeb extends WebPlugin {\n    async login() {\n        throw this.unimplemented('카카오 로그인은 네이티브 앱 환경에서만 지원됩니다.');\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":[],"mappings":";;AACA;AACK,MAAC,UAAU,GAAG,cAAc,CAAC,YAAY,EAAE;AAChD,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;AAC/D,CAAC;;ACHD;AACO,MAAM,aAAa,SAAS,SAAS,CAAC;AAC7C,IAAI,MAAM,KAAK,GAAG;AAClB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,8BAA8B,CAAC;AAChE,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.js

@@ -0,0 +1,26 @@
+var capacitorKakaoLogin = (function (exports, core) {
+    'use strict';
+
+    // 플러그인 등록명은 iOS jsName 및 Android @CapacitorPlugin(name) 과 반드시 일치해야 한다.
+    const KakaoLogin = core.registerPlugin('KakaoLogin', {
+        web: () => Promise.resolve().then(function () { return web; }).then(m => new m.KakaoLoginWeb()),
+    });
+
+    // 카카오 로그인은 네이티브 앱 환경 전용이므로, 웹 구현체는 unimplemented 에러를 던진다.
+    class KakaoLoginWeb extends core.WebPlugin {
+        async login() {
+            throw this.unimplemented('카카오 로그인은 네이티브 앱 환경에서만 지원됩니다.');
+        }
+    }
+
+    var web = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        KakaoLoginWeb: KakaoLoginWeb
+    });
+
+    exports.KakaoLogin = KakaoLogin;
+
+    return exports;
+
+})({}, capacitorExports);
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\n// 플러그인 등록명은 iOS jsName 및 Android @CapacitorPlugin(name) 과 반드시 일치해야 한다.\nconst KakaoLogin = registerPlugin('KakaoLogin', {\n    web: () => import('./web').then(m => new m.KakaoLoginWeb()),\n});\nexport * from './definitions';\nexport { KakaoLogin };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\n// 카카오 로그인은 네이티브 앱 환경 전용이므로, 웹 구현체는 unimplemented 에러를 던진다.\nexport class KakaoLoginWeb extends WebPlugin {\n    async login() {\n        throw this.unimplemented('카카오 로그인은 네이티브 앱 환경에서만 지원됩니다.');\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;IACA;AACK,UAAC,UAAU,GAAGA,mBAAc,CAAC,YAAY,EAAE;IAChD,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;IAC/D,CAAC;;ICHD;IACO,MAAM,aAAa,SAASC,cAAS,CAAC;IAC7C,IAAI,MAAM,KAAK,GAAG;IAClB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,8BAA8B,CAAC;IAChE,IAAI;IACJ;;;;;;;;;;;;;;;"}

package/ios/Package.swift

@@ -0,0 +1,29 @@
+// swift-tools-version: 5.9
+import PackageDescription
+
+let package = Package(
+    name: "KakaoLoginPlugin",
+    platforms: [.iOS(.v13)],
+    products: [
+        .library(
+            name: "KakaoLoginPlugin",
+            targets: ["KakaoLoginPlugin"]
+        )
+    ],
+    dependencies: [
+        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "6.0.0"),
+        .package(url: "https://github.com/kakao/kakao-ios-sdk", from: "2.23.0"),
+    ],
+    targets: [
+        .target(
+            name: "KakaoLoginPlugin",
+            dependencies: [
+                .product(name: "Capacitor", package: "capacitor-swift-pm"),
+                .product(name: "Cordova", package: "capacitor-swift-pm"),
+                .product(name: "KakaoSDKAuth", package: "kakao-ios-sdk"),
+                .product(name: "KakaoSDKUser", package: "kakao-ios-sdk"),
+            ],
+            path: "Sources/KakaoLoginPlugin"
+        )
+    ]
+)

package/ios/Sources/KakaoLoginPlugin/KakaoLoginPlugin.swift

@@ -0,0 +1,57 @@
+import Foundation
+import Capacitor
+import KakaoSDKAuth
+import KakaoSDKUser
+
+/// Capacitor 플러그인 — 카카오 소셜 로그인
+/// npx cap sync 시 @objc(KakaoLoginPlugin) 패턴으로 자동 탐색된다.
+@objc(KakaoLoginPlugin)
+public class KakaoLoginPlugin: CAPPlugin, CAPBridgedPlugin {
+
+    public let identifier = "KakaoLoginPlugin"
+    public let jsName = "KakaoLogin"
+    public let pluginMethods: [CAPPluginMethod] = [
+        CAPPluginMethod(name: "login", returnType: CAPPluginReturnPromise)
+    ]
+
+    @objc func login(_ call: CAPPluginCall) {
+        DispatchQueue.main.async {
+            if UserApi.isKakaoTalkLoginAvailable() {
+                // 카카오톡 앱 로그인
+                UserApi.shared.loginWithKakaoTalk { [weak self] oauthToken, error in
+                    self?.handleLoginResult(call: call, oauthToken: oauthToken, error: error)
+                }
+            } else {
+                // 카카오 계정 웹뷰 로그인 (카카오톡 미설치 환경)
+                UserApi.shared.loginWithKakaoAccount { [weak self] oauthToken, error in
+                    self?.handleLoginResult(call: call, oauthToken: oauthToken, error: error)
+                }
+            }
+        }
+    }
+
+    private func handleLoginResult(call: CAPPluginCall, oauthToken _: OAuthToken?, error: Error?) {
+        if let error = error {
+            DispatchQueue.main.async {
+                call.reject("카카오 로그인 실패", nil, error)
+            }
+            return
+        }
+
+        UserApi.shared.me { user, error in
+            DispatchQueue.main.async {
+                if let error = error {
+                    call.reject("카카오 사용자 정보 조회 실패", nil, error)
+                    return
+                }
+
+                guard let userId = user?.id else {
+                    call.reject("카카오 사용자 ID를 가져올 수 없습니다")
+                    return
+                }
+
+                call.resolve(["socialId": String(userId)])
+            }
+        }
+    }
+}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@chuseok22/capacitor-kakao-login",
+  "version": "0.1.1",
+  "description": "Capacitor plugin for Kakao social login (iOS & Android)",
+  "main": "dist/plugin.cjs.js",
+  "module": "dist/plugin.esm.js",
+  "types": "dist/esm/index.d.ts",
+  "unpkg": "dist/plugin.js",
+  "files": [
+    "dist/",
+    "ios/",
+    "android/",
+    "CapacitorKakaoLogin.podspec"
+  ],
+  "author": "Baek Jihoon",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/chuseok22/capacitor-kakao-login.git"
+  },
+  "keywords": [
+    "capacitor",
+    "plugin",
+    "kakao",
+    "kakao-login",
+    "social-login",
+    "ios",
+    "android"
+  ],
+  "scripts": {
+    "build": "npm run clean && tsc && rollup -c rollup.config.js",
+    "clean": "rimraf ./dist",
+    "lint": "eslint . --ext ts",
+    "fmt": "prettier --write --parser typescript 'src/**/*.ts'",
+    "verify:web": "npm run build"
+  },
+  "devDependencies": {
+    "@capacitor/android": "^6.0.0",
+    "@capacitor/core": "^6.0.0",
+    "@capacitor/ios": "^6.0.0",
+    "@ionic/eslint-config": "^0.3.0",
+    "@ionic/prettier-config": "~1.0.1",
+    "@rollup/plugin-node-resolve": "^15.0.0",
+    "eslint": "^7.32.0",
+    "prettier": "~2.3.2",
+    "rimraf": "^5.0.0",
+    "rollup": "^4.0.0",
+    "typescript": "~5.1.3"
+  },
+  "peerDependencies": {
+    "@capacitor/core": ">=6.0.0"
+  },
+  "capacitor": {
+    "ios": {
+      "src": "ios"
+    },
+    "android": {
+      "src": "android"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}