認証・HTTP

アクセス権限

provideKitAuth() は user、confirm、required、anonymous、unavailable の認証状態に対応するfunctional Route Guardを設定します。Redirect routeとアプリ固有の副作用は利用側に残します。

KitAuthAccessService は現在のsessionが実行できる操作を公開します。

Authoritativeな required はsign-outであり、Offline Accessへ変換してはいけません。以前検証したLocal Sessionを有効化できるのはtransport結果が unavailable の場合だけです。

provideKitAuth(() => ({
  authState: () => inject(AuthService).state$,
  redirects: {
    whenAuthorized: '/home',
    whenConfirming: '/auth/confirm',
    whenNotConfirming: '/auth/signin',
    whenUnauthorized: '/auth',
  },
  isUnavailableError: (error) => isOfflineFallbackError(error),
}));

Route定義では kitRequiredUnauthorizedGuard、kitRequireConfirmingGuard、kitRequireAuthorizedGuard を使います。保護対象の非同期判定開始時には、現在のauthorization leaseが成功するまで以前のremote権限を一時停止します。

HTTPポリシー

provideKitHttp() はcredential付与、bypass規則、一時障害処理、アプリのerror hookを備えた kitAuthInterceptor を設定します。

自動retryは GET、HEAD、OPTIONS または Idempotency-Key を持つrequestだけです。通常のwriteは自動retryしません。一時status 0、408、429、502、503、504 を対象にし、Retry-After を尊重します。

Offline対応時は offlineInterceptor を kitAuthInterceptor より前に登録します。Local modeではcredential生成とnetwork transportを止めながら、一致するread policyがスコープ付きReplicaを返せます。