feat: 生成コードを Autogen 名前空間へ移行する

[masatoi]

前提: pokepay-sdk-generator#77 のマージが必要です。この PR の生成コードは同 PR の生成器で出力しています。

背景

ios-sdk の生成器は手書きコードと同じディレクトリ・同じ型名前空間に出力していました。pokepay-server の api-response-validation-tests ブランチ（x-pokepay-mobile-sdk を 55 → 153 箇所に拡大）で再生成すると、生成器が変更した 57 ファイルのうち 55 が手書きファイルの上書きになります。

このリポジトリは 188 の swift ファイルのうち 50 だけが生成管理下（DO NOT EDIT ヘッダ付き）で、残り 138 は手書きです。失われるはずだった API の例:

 public extension BankAPI.Account {
     struct CreateAccountCpmToken: BankRequest {
-        public enum Scope: Int { case PAYMENT = 1; case TOPUP = 2; case BOTH = 3 }
-        public let scopes: Int
-        public let metadata: [String:String]?
-        public typealias Response = AccountCpmToken
-        public init(accountId: String, scopes: Scope = .PAYMENT, ...)
+        public let scopes: [String]?
+        public let metadata: String?
+        public typealias Response = CpmToken
+        public init(scopes: [String]? = nil, ..., accountId: String)

pokepay-sdk-generator#77 で生成器は Sources/Pokepay/Autogen/ の外へ一切書かなくなりました。この PR はその移行です。

変更内容

1. 旧位置の生成物 50 ファイルを手書きに凍結（fbbd0b9）

DO NOT EDIT ヘッダを外し、delete-all-generated-files の対象から外しました。削除行 50・追加行ゼロ（ヘッダ 1 行ずつ）です。

この 50 件には Sources/Pokepay/BankAPI.swift が含まれます。生成器はこのファイルを出力しなくなるため、凍結しなければ次の再生成で削除され、手書き層の名前空間宣言が失われて手書き API が全滅していました。

凍結により BankAPI.Terminal.Get / BankAPI.CreditCard.GetCreditCards などの既存 API がそのまま残ります。

2. 生成コードを Sources/Pokepay/Autogen/ に追加（667ce50）

152 ファイル（Autogen/Responses/ に 71、Autogen/BankAPI/<Tag>/ に 80、Autogen.swift 1）。

public enum Autogen {
    public enum Responses {}
    public enum BankAPI { public enum Terminal {} }
}
public extension Autogen.Responses { struct Terminal: Codable { ... } }
public extension Autogen.BankAPI.Terminal {
    struct GetTerminal: BankRequest {
        public typealias Response = Autogen.Responses.Terminal
    }
}

Swift には Java のパッケージに相当するスコープが無く 1 モジュール内の型名がフラットなので、ネストした caseless enum で手書きと分離しています。ファイル名に Autogen 接頭辞が付いているのは、SwiftPM が 1 ターゲット内で basename の重複を許さないため（オブジェクトファイル名を basename から導く）です。接頭辞が無いと Autogen/Responses/Account.swift と手書きの Responses/Account.swift が multiple producers エラーになります。ファイル名は Swift の API の一部ではないので公開 API への影響はありません。

互換性

既存の公開 API は無傷です。 手書き 188 ファイルへの変更・削除は一切ありません。

系統	例	状態
手書き	BankAPI.Terminal.Get()	変更なし
凍結（旧生成物）	BankAPI.CreditCard.GetCreditCards(...)	変更なし
生成（新規）	Autogen.BankAPI.Terminal.GetTerminal()	追加
高レベル API	Pokepay.Client	変更なし

同名のレスポンス型（Terminal と Autogen.Responses.Terminal）は名前空間が違うので別型として共存します。

検証

項目	結果
手書きファイルへの変更・削除	0 件
Autogen/ 外への出力	0 件
basename 重複	0 件
swift build（SwiftPM / macOS ターゲット、生成 152 + 手書き 188 = 340 ファイル）	Build complete!
手書き・凍結・生成の共存	消費側パッケージから 3 系統すべて呼び出し可能

dev 環境の実 API（17/17 成功）

生成型 Autogen.BankAPI.* / Autogen.Responses.* を参照して https://api-dev.pokepay.jp を叩きました。

[参照系]              6/6 ✓  terminals(両トークン) / users/{id} / accounts / private-moneys
[Cashtray 決済フロー] 6/6 ✓  店舗が Cashtray 作成 → エンドユーザが支払い → 残高 141.0→142.0
                            → 取引照会 → 店舗が返金 → 残高 141.0 に復帰
[CPM トークン]        2/2 ✓  metadata=["purpose": "autogen-verify"] のデコード確認
[Bill]                3/3 ✓  作成 → 照会 → 削除(204)

返金により dev の残高は検証前の状態に戻しています。

注: この環境には Xcode が無いため（CLT のみ）、検証は SwiftPM の macOS ターゲットで行っています。Sources/ 配下に #if os(iOS) も UIKit 依存も無く全 340 ファイルがコンパイル対象になるため、検証手段として有効です。iOS シミュレータ／実機でのビルドは未検証です。

既知の制限（この PR のスコープ外）

Xcode プロジェクトへのファイル登録

Pokepay.xcodeproj/project.pbxproj は .swift を個別列挙しており、この PR では生成 152 ファイルを登録していません。Carthage 利用者はこのままではビルドできません。

ただしこれはこの PR で始まった問題ではありません。移行前の時点で pbxproj への登録は 190 件、ディスク上の Sources/ は 188 件+α で、以前から未登録が発生していました（直近では 2026-07-24 の "Added mission file references" で人手により補われています）。今回 152 件増えて未登録が 290 件規模になります。

配布経路	影響
CocoaPods（Pokepay.podspec）	なし。Sources/**/*.swift の glob
SwiftPM（Package.swift）	なし。既定パス
Carthage（Pokepay.xcodeproj）	あり。別途登録が必要

.gitattributes で *.pbxproj -diff 指定のため差分レビューが効かず、290 件規模の変更をこの PR に混ぜるとレビュー不能になります。別 PR で一括対応するのが適切と判断しました。

バージョン

SDKVersion.swift と Pokepay.podspec は 2.1.0 のままです。過去の運用に合わせ、bump はリリース作業として別途行ってください。既存 API の破壊は無いので semver 上は minor bump が妥当です。

空スキーマの CodingKeys

プロパティを持たないスキーマは空の CodingKeys を出力し Swift として不正になります（an enum with no cases cannot declare a raw type）。この PR による退行ではなく、旧実装でも同じ出力になることを確認済みです。現行スペックに該当スキーマが無いため顕在化していません。生成器側で別途対応する話です。

🤖 Generated with Claude Code