[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBJ3RCEAAKTR2VE2D90GRN":3,"skill-same:01M6CBJ3RCEAAKTR2VE2D90GRN":55},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":20,"linkOnly":21,"markdownContent":22,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":13,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M6CBJ3RCEAAKTR2VE2D90GRN","23-firebase-callable-manager",null,"devwinsoft\u002Fdevian","devwinsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F22570160?v=4","01M6C6RR8W05NH8NPKQNCE3Q72","maoshy","01M6C6RRDJ5TJJCZXRTY801YDH",0,"MIT","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F50-mobile-package\u002F23-firebase-callable-manager\u002FSKILL.md",[],[18,19],"firebase","23 firebase callable manager","2026-11-10 10:12:30",false,"# 23-firebase-callable-manager — FirebaseCallableManager\n\n\nStatus: ACTIVE\nAppliesTo: v10\n\n\n## Purpose\n\nFirebase Cloud Functions callable 통합 래퍼.\n함수별 typed API, 에러 매핑, 응답 파싱, region 관리, 값 추출 헬퍼를 통합한다.\n`FirebaseFunctions` 인스턴스는 외부에 노출하지 않는다.\ngame 도메인 테이블(TB_PURCHASE 등)은 참조하지 않는다 - 서버 응답 raw 값을 typed result에 그대로 저장한다.\n\n**`internal sealed class`** - 같은 어셈블리(`Devian.Samples.MobilePackage`) 내부에서만 접근 가능하다.\n외부 어셈블리(Assembly-CSharp 등)에서는 직접 접근할 수 없으며, `LoginManager`\u002F각 시스템 매니저를 통해 간접 사용한다.\n\n\n## Scope\n\n| 포함 | 제외 |\n|------|------|\n| Functions region 관리 | Firebase Auth (AccountLoginFirebase 소관) |\n| 함수별 typed public API | Firebase 의존성 초기화 (`CheckAndFixDependenciesAsync`) |\n| FunctionsException 에러 매핑 (per-function) | 도메인 변환 (ResolveRewardGroupId 등) |\n| 응답 파싱 -> typed result | Editor 전용 mock (각 manager 자체 처리) |\n| 응답 정규화 (internal) | |\n| 값 추출 헬퍼 (`ReadLong`\u002F`ReadString`\u002F`ReadBool`) | |\n\n\n## Sample SSOT\n- `com.devian.foundation\u002FSamples~\u002FMobilePackage`\n\n\n## Implementation Location (3-path mirror)\n\n> 3-path mirror 정책: [devian-unity\u002F04-package-policy](..\u002F..\u002F04-package-policy\u002FSKILL.md)\n\n- UPM (정본): `framework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FFirebaseCallable\u002FFirebaseCallableManager.cs`\n- Packages (sync): `framework-cs\u002Fapps\u002FUnityExample\u002FPackages\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FFirebaseCallable\u002FFirebaseCallableManager.cs`\n- Assets\u002FSamples (import): `framework-cs\u002Fapps\u002FUnityExample\u002FAssets\u002FSamples\u002FDevian Samples\u002F{version}\u002FMobilePackage\u002FRuntime\u002FFirebaseCallable\u002FFirebaseCallableManager.cs`\n\n\n## Singleton\n\n`CompoSingleton\u003CFirebaseCallableManager>` 기반.\nBootstrap prefab에 부착한다.\n`MobileApplication`에 `[RequireComponent(typeof(FirebaseCallableManager))]`로 선언.\n\n\n## API\n\n> FirebaseCallableManager는 `internal` 클래스이므로 같은 어셈블리 내부에서만 접근 가능하다.\n\n### Instance Methods - Region\n\n- `onInitAwake()`에서 `MobileApplication.Instance.FirebaseFunctionsRegion`을 읽어 internal region을 초기화한다.\n- region 값이 비어 있으면 기본 리전(`us-central1`)을 사용한다.\n- `getFunctionsInstance()` 호출 시 region이 비어 있으면 `MobileApplication.Instance`를 다시 참조해 lazy 초기화를 시도한다.\n\n### Instance Methods - Purchase callable (7개)\n\n- `VerifyPurchaseAsync(data, ct) -> Task\u003CCommonResult\u003CVerifyPurchaseResponse>>`\n  - `verifyPurchase` callable 호출 -> 응답 파싱 -> `VerifyPurchaseResponse` 반환\n  - 에러 매핑: `PURCHASE_UNAUTHENTICATED`, `PURCHASE_VERIFY_INVALID_ARGUMENT`, `PURCHASE_VERIFY_FAILED_PRECONDITION`, `PURCHASE_VERIFY_CALL_FAILED`, `PURCHASE_NETWORK_UNAVAILABLE`\n- `GetEntitlementsAsync(ct) -> Task\u003CCommonResult\u003CEntitlementsSnapshot>>`\n  - `getEntitlements` callable 호출 -> 응답 파싱 -> `EntitlementsSnapshot` 반환\n  - 응답 원본 값을 그대로 반환한다.\n- `GetRecentPurchases30dAsync(data, ct) -> Task\u003CCommonResult\u003CRecentPurchaseItem>>`\n  - `getRecentPurchases30d` callable 호출 -> items[0] 파싱 -> `RecentPurchaseItem` 반환\n  - 아이템 없으면 `PURCHASE_RECENT_NOT_FOUND`\n- `GetPurchaseAdjustmentsAsync(data, ct) -> Task\u003CCommonResult\u003CRefundPageResult>>`\n  - `getPurchaseAdjustments` callable 호출 -> 페이지네이션 파싱 -> `RefundPageResult` 반환\n  - `PurchaseAdjustmentItem`은 서버 raw 필드만 포함. domain 변환은 PurchaseManager가 수행.\n- `AckPurchaseClientGrantAsync(data, ct) -> Task\u003CCommonResult>`\n  - `ackPurchaseClientGrant` callable 호출\n- `AckPurchaseStoreConfirmAsync(data, ct) -> Task\u003CCommonResult>`\n  - `ackPurchaseStoreConfirm` callable 호출\n- `AckRefundAppliedAsync(data, ct) -> Task\u003CCommonResult>`\n  - `ackRefundApplied` callable 호출\n\n### Static Methods (순수 함수)\n\n- `ReadLong(IDictionary\u003Cstring, object> source, string key) -> long`\n  - 지정 키의 값을 `long`으로 추출한다.\n  - `long`, `int`, `double`, `float`, `string` 타입을 처리한다.\n  - 키가 없거나 변환 불가 시 `0L` 반환.\n\n- `ReadString(IDictionary\u003Cstring, object> source, string key) -> string`\n  - 지정 키의 값을 `string`으로 추출한다.\n  - 키가 없거나 null이면 `string.Empty` 반환.\n\n- `ReadBool(IDictionary\u003Cstring, object> source, string key) -> bool`\n  - 지정 키의 값을 `bool`로 추출한다.\n  - `bool`, `int`, `long`, `double`, `string` 타입을 처리한다.\n  - 키가 없거나 변환 불가 시 `false` 반환.\n\n### Private Methods (네이밍: 소문자 시작)\n\n- `callFunctionAsync()` - callable 호출 + 응답 정규화 (raw dict 반환)\n- `getFunctionsInstance()` - 리전 기반 `FirebaseFunctions` 인스턴스 획득\n- `normalizeCallableResponse()` - 재귀적 응답 정규화\n- `normalizeStringObjectMap()`, `normalizeAnyMap()`, `normalizeCallableValue()` - 정규화 내부 헬퍼\n\n\n## Integration\n\n### PurchaseManager\n```csharp\nvar result = await FirebaseCallableManager.Instance.VerifyPurchaseAsync(data, ct);\nif (result.IsFailure)\n    return CommonResult\u003CVerifyPurchaseResponse>.Failure(result.Error!);\nvar response = result.Value!;\n```\nPurchaseManager는 `FunctionsException`을 catch하지 않는다. 에러 매핑은 FirebaseCallableManager가 수행한다.\ndomain 변환(ResolveRewardGroupId 등)은 PurchaseManager가 typed result 수신 후 수행한다.\nPurchaseManager는 같은 어셈블리이므로 `internal` FirebaseCallableManager에 직접 접근 가능하다.\n\n### MobileApplication\n```csharp\n\u002F\u002F MobileApplication은 FirebaseCallableManager region을 직접 설정하지 않는다.\n\u002F\u002F FirebaseCallableManager가 MobileApplication.Instance.FirebaseFunctionsRegion을 읽어 자체 초기화한다.\n```\n\n\n## Hard Rules\n\n- `FirebaseFunctions` 인스턴스를 외부에 노출하지 않는다.\n- `FunctionsException` 에러 매핑은 FirebaseCallableManager 각 메서드 내부에서 수행한다. 호출자는 `CommonResult`만 소비한다.\n- FirebaseCallableManager는 game 도메인 테이블(TB_PURCHASE 등)을 참조하지 않는다. 서버 응답 raw 값을 typed result에 그대로 저장한다.\n- Firebase Auth 관련 로직은 `AccountLoginFirebase`가 소유한다. FirebaseCallableManager는 Auth를 다루지 않는다.\n- Firebase Functions region 설정 owner는 `MobileApplication`이고, 실제 region 초기화는 `FirebaseCallableManager`가 `MobileApplication.Instance` 참조로 수행한다.\n- 외부에서 사용하지 않는 메서드는 `private`으로 선언하고 소문자로 시작한다.\n- Editor mock 응답은 각 manager가 자체 처리한다. FirebaseCallableManager는 Editor 전용 분기를 갖지 않는다.\n\n\n## Related\n\n- [11-mobile-application](..\u002F11-mobile-application\u002FSKILL.md) — Bootstrap, RequireComponent, region 설정\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F50-mobile-package\u002F23-firebase-callable-manager","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft","Kim Hyong Joon","2026-04-12 18:44:10",{"source":7,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add devwinsoft\u002Fdevian --skill 23-firebase-callable-manager",{"tool":37,"command":38},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 23-firebase-callable-manager",{"tool":40,"command":41},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 23-firebase-callable-manager","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F50-mobile-package\u002F23-firebase-callable-manager\u002FSKILL.md",true,[45,51],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"examples.md","REFERENCE","参考文档",4426,"https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fworkflow-automation\u002Fplanning-with-files\u002Fexamples.md",{"path":52,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":53,"sourceHtmlUrl":54},"reference.md",3478,"https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fworkflow-automation\u002Fplanning-with-files\u002Freference.md",[56,62,70,78,87,94],{"skillNo":57,"name":58,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":20},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[58],{"skillNo":63,"name":64,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":20},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[68,69],"archive","90 project archive",{"skillNo":71,"name":72,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":20},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[76,77],"management","30 env management",{"skillNo":79,"name":80,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":20},"01M6CBWYD3TGWBQV7V35551THF","19-page-push-send","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F19-page-push-send\u002FSKILL.md",[],[84,85,86],"push","page","19 page push send",{"skillNo":88,"name":89,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":20},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[85,93],"18 page savedata",{"skillNo":95,"name":96,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":20},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[85,100],"17 page deobfuscate"]