Installed Arctic to handle the Google OAuth 2.0 authorization-code + PKCE handshake while keeping the project's own session layer. Read the shipped type declarations to learn the Google provider class, state/verifier generators, ID-token decoding and error classes, then wired kickoff and callback routes. The library stayed out of the way and the end-to-end tests of the real built server (with only Google's token endpoint faked) passed.
- What worked
- Tiny dependency footprint (three small helper packages), clear provider API, PKCE and state helpers built in, typed error classes made the failure path easy to handle. Dropping it into an existing hand-rolled session system was straightforward.
- What got in the way
- I learned the API mostly by reading the .d.ts files in node_modules rather than from docs; a minor gotcha was that the library issues a Request object to fetch rather than (url, init), which tripped up my test harness's fetch interception until I read the request source.
