mochiOS App Store

store.mochios.orgで公開するmochiOS向けApp Storeです。フロントエンドはNext.js + OpenNext、APIはRust + workers-rsで実装し、どちらもCloudflare WorkersへWranglerで公開します。

ストアフロント

ストアフロントはApp Store APIの承認済み実データだけを表示します。GET /storefrontを基準に見つける画面を構成し、アプリ、ゲーム、カテゴリ、検索、App詳細を提供します。架空アプリ、代替画像、フロントエンド固定の特集文言は使用しません。

App詳細では公開中Releaseの固定GitHub Releases配布先、ファイル名、SHA-256、Package digestを確認できます。APIが利用できない場合は空のカタログに見せず、再読み込み可能なエラーを表示します。

現在実装している管理基盤

• App、Build、Submission、Review、公開状態を分離したD1モデル
• GitHub Releases上の固定.mpkg assetを使うBuild登録と直接ダウンロード
• 審査待ちReleaseを排他的に取得する自動MPKG Reviewer Queue
• DraftからRejectedまでのSubmissionワークフロー
• Store Listing、Capability、通信先、Privacy、課金、Content、動的コード、AI、テスト情報の申告
• 512×512 PNG／JPEGアイコンの実体検査と、3枚以上のスクリーンショット検査
• Available／Developer Unpublished／Removedを審査状態から分離した公開管理
• 回数制限のないAppeal、append-only Review／公開履歴
• 1 Appにつき1つのcurrent Developer Certificateと、失効後の安全な置換
• Developer／運営者向け通知、Account単位の未読管理

利用者向けストアフロントはモックを表示しません。公開中のAppがない場合は、理由を簡潔に示す空の状態を表示します。

API設定

APIはapi/にあります。D1にはRelease metadata、SHA-256、署名、審査状態だけを保存し、.mpkg本体はGitHub Releasesから配布します。Developer認証とCertificate確認にはAccounts／DeveloperCAのService Bindingを使用します。

npm run api:check
npm run api:test
npm run api:migrate:local
npm run api:dev

別ターミナルでフロントエンドを起動すると、メンテナンス画面を確認できます。

$env:APPSTORE_API_BASE_URL='http://127.0.0.1:8787/v1'
npm run dev

主な公開API:

GET /apps
GET /apps/{bundle_id}
GET /apps/{bundle_id}/status
POST /apps/{bundle_id}/acquisitions
GET /apps/{bundle_id}/download
GET /search?q={query}
GET /storefront

アプリアイコンはAPIレスポンスのiconで指定します。フロントエンド側で絵文字や生成画像へ置き換えません。 ストアフロントはこれらの公開APIだけを呼び出し、管理用情報や審査中データは表示しません。

ローカル開発

npm install
npm run dev

Cloudflare Workersと同じ実行環境で確認する場合:

npm run preview

検証

npm run lint
npx tsc --noEmit
npm run build
npx opennextjs-cloudflare build
npx wrangler deploy --dry-run
npm run reviewer:check
npm run reviewer:test

本番Reviewer RunnerはGitHub Actionsが1時間ごとに最大1件処理します。AppStoreリポジトリのRepository Secretに、AppStore APIのREVIEWER_TOKENと同じ値を設定してください。

APPSTORE_REVIEWER_TOKEN

手動実行はGitHubのActions → MPKG Reviewer → Run workflowから行えます。ローカルで常駐させる場合は次を実行します。

$env:APPSTORE_REVIEWER_TOKEN='<AppStore API REVIEWER_TOKEN>'
cargo run --release --manifest-path reviewer/Cargo.toml -- --queue

MPKG形式と署名対象はdocs/appbundle.md、審査ツールはreviewer/README.mdを参照してください。

公開

npx wrangler secret put ADMIN_TOKEN --config api/wrangler.jsonc
npx wrangler secret put REVIEWER_TOKEN --config api/wrangler.jsonc
npx wrangler secret put APPSTORE_SERVICE_TOKEN --config api/wrangler.jsonc
npm run api:migrate:remote
npm run api:deploy
npm run deploy

Custom Domainはフロントエンドがstore.mochios.org、APIがapi.store.mochios.orgです。詳細はapi/README.mdを参照してください。