…proxy logic (#124)

* wip: commit progress on UrlSync class/hook

* refactor: consolidate emoji-testing logic

* docs: update comments for clarity

* refactor: rename helpers to renderHelpers

* wip: finish initial implementation of UrlSync

* chore: finish tests for UrlSync class

* chore: add mock DiscoveryApi helper

* chore: finish tests for useUrlSync

* refactor: consolidate mock URL logic for useUrlSync

* fix: update test helper to use API list

* fix: remove unneeded imports

* fix: get tests for all current code passing

* fix: remove typo

* fix: update useUrlSync to expose underlying api

* refactor: increase data hiding for hook

* fix: make useUrlSync tests less dependent on implementation details

* refactor: remove reliance on baseUrl argument for fetch calls

* refactor: split Backstage error type into separate file

* refactor: clean up imports for api file

* refactor: split main query options into separate file

* consolidate how mock endpoints are defined

* fix: remove base URL from auth calls

* refactor: consolidate almost all auth logic into CoderAuthProvider

* move api file into api directory

* fix: revert prop that was changed for debugging

* fix: revert prop definition

* refactor: extract token-checking logic into middleware for server

* refactor: move shared auth key to queryOptions file

* docs: add reminder about arrow functions

* fix: remove configApi from embedded class properties

* fix: update query logic to remove any whitespace

* wip: commit progress on UrlSync class/hook

* refactor: consolidate emoji-testing logic

* docs: update comments for clarity

* refactor: rename helpers to renderHelpers

* wip: finish initial implementation of UrlSync

* chore: finish tests for UrlSync class

* chore: add mock DiscoveryApi helper

* chore: finish tests for useUrlSync

* refactor: consolidate mock URL logic for useUrlSync

* fix: update test helper to use API list

* fix: remove unneeded imports

* fix: get tests for all current code passing

* fix: remove typo

* fix: update useUrlSync to expose underlying api

* refactor: increase data hiding for hook

* fix: make useUrlSync tests less dependent on implementation details

* refactor: remove reliance on baseUrl argument for fetch calls

* refactor: split Backstage error type into separate file

* refactor: clean up imports for api file

* refactor: split main query options into separate file

* consolidate how mock endpoints are defined

* fix: remove base URL from auth calls

* refactor: consolidate almost all auth logic into CoderAuthProvider

* move api file into api directory

* fix: revert prop that was changed for debugging

* fix: revert prop definition

* refactor: extract token-checking logic into middleware for server

* refactor: move shared auth key to queryOptions file

* docs: add reminder about arrow functions

* wip: add initial versions of CoderClient code

* wip: delete entire api.ts file

* fix: remove temp api escape hatch for useUrlSync

* chore: update syncToken logic to use temporary interceptors

* refactor: update variable name for clarity

* fix: prevent double-cancellation of timeout signals

* fix: cleanup timeout logic

* refactor: split pseudo-SDK into separate file

* fix: resolve issue with conflicting interceptors

* chore: improve cleanup logic

* fix: update majority of breaking tests

* fix: resolve all breaking tests

* fix: beef up CoderClient validation logic

* chore: commit first passing test for CoderClient

* fix: update error-detection logic in test

* wip: add all test stubs for CoderClient

* chore: add test cases for syncToken's main return type

* chore: add more test cases

* fix: remove Object.freeze logic

* refactor: consolidate mock API endpoints in one spot

* wip: commit current test progress

* refactor: rename mock API endpoint variable for clarity

* chore: finish test for aborting queued requests

* chore: finish initial versions of all CoderClient tests

* fix: delete helper that was never used

* fix: update getWorkspacesByRepo function signature to be more consistent with base function

* docs: add comment reminder about arrow functions for CoderClient

* docs: add comment explaining use of interceptor logic

* fix: update return type of getWorkspacesByRepo function

* fix: remove configApi from embedded class properties

* fix: update query logic to remove any whitespace

* refactor: simplify interceptor removal logic

* refactor: update how Backstage SDK is set up

* refactor: update dummy request for authenticating

* fix: add user parsing logic to CoderClient

…ndpoint definitions (#126)

* wip: commit progress on UrlSync class/hook

* refactor: consolidate emoji-testing logic

* docs: update comments for clarity

* refactor: rename helpers to renderHelpers

* wip: finish initial implementation of UrlSync

* chore: finish tests for UrlSync class

* chore: add mock DiscoveryApi helper

* chore: finish tests for useUrlSync

* refactor: consolidate mock URL logic for useUrlSync

* fix: update test helper to use API list

* fix: remove unneeded imports

* fix: get tests for all current code passing

* fix: remove typo

* fix: update useUrlSync to expose underlying api

* refactor: increase data hiding for hook

* fix: make useUrlSync tests less dependent on implementation details

* refactor: remove reliance on baseUrl argument for fetch calls

* refactor: split Backstage error type into separate file

* refactor: clean up imports for api file

* refactor: split main query options into separate file

* consolidate how mock endpoints are defined

* fix: remove base URL from auth calls

* refactor: consolidate almost all auth logic into CoderAuthProvider

* move api file into api directory

* fix: revert prop that was changed for debugging

* fix: revert prop definition

* refactor: extract token-checking logic into middleware for server

* refactor: move shared auth key to queryOptions file

* docs: add reminder about arrow functions

* wip: add initial versions of CoderClient code

* wip: delete entire api.ts file

* fix: remove temp api escape hatch for useUrlSync

* chore: update syncToken logic to use temporary interceptors

* refactor: update variable name for clarity

* fix: prevent double-cancellation of timeout signals

* fix: cleanup timeout logic

* refactor: split pseudo-SDK into separate file

* fix: resolve issue with conflicting interceptors

* chore: improve cleanup logic

* fix: update majority of breaking tests

* fix: resolve all breaking tests

* fix: beef up CoderClient validation logic

* chore: commit first passing test for CoderClient

* fix: update error-detection logic in test

* wip: add all test stubs for CoderClient

* chore: add test cases for syncToken's main return type

* chore: add more test cases

* fix: remove Object.freeze logic

* refactor: consolidate mock API endpoints in one spot

* wip: commit current test progress

* refactor: rename mock API endpoint variable for clarity

* chore: finish test for aborting queued requests

* chore: finish initial versions of all CoderClient tests

* fix: delete helper that was never used

* fix: update getWorkspacesByRepo function signature to be more consistent with base function

* docs: add comment reminder about arrow functions for CoderClient

* docs: add comment explaining use of interceptor logic

* fix: update return type of getWorkspacesByRepo function

* fix: finish initial implementation of new API logic

* wip: commit progress for updating test setup

* fix: update test for CoderClient

* fix: update more tests

* fix: get all tests passing

* chore: remove all build parameter logic

* fix: add check for missing key/value for workspaces query

…not mounted (#128)

* wip: commit progress on fallback UI

* chore: move dep to peer dependencies

* wip: commit more progress

* wip: more progress

* refactor: consolidate card logic

* fix: update component tracking hooks

* fix: add a11y landmark to auth fallback

* wip: commit more style progress

* wip: commit more progress

* wip: more progress

* wip: cleanup current approach

* wip: commit progress on observer approach

* wip: fix infinite loop for mutation logic

* fix: prevent padding patches from firing too often

* fix: improve scoping of style overrides

* chore: finish intial version of fallback stylling

* fix: tidy up types

* wip: create initial version of dialog form

* wip: commit progress on modal

* chore: finish styling for modal wrapper

* fix: update padding for FormDialog

* wip: start extracting out auth form

* fix: add missing barrel export file

* fix: make sure that auth form isn't dismissed early

* fix: update auth imports

* fix: update spacing for auth modal

* refactor: clean up auth provider for clarity

* docs: rewrite comment for clarity

* fix: improve granularity between official Coder components and user components

* fix: update all internal consumers of useCoderAuth

* wip: commit initial version of useCoderQuery helper hook

* refactor: rename hooks to avoid confusion

* fix: update exports for plugin

* docs: fill in incomplete sentence

* wip: commit initial version of useMutation wrapper

* refactor: extract retry factor into global constant

* fix: add explicit return type to useCoderMutation

* wip: start extracting auth logic into better reusable components

* fix: update card to have better styling for body

* wip: commit progress on style refactoring

* fix: update vertical padding for card wrapper

* chore: delete CoderAuthWrapper component

* fix: update styling for auth fallback

* chore: shrink size of PR

* fix: update imports

* docs: add comment about description setup

* fix: remove risk of runtime render errors in auth form

* fix: update imports

* fix: update font sizes to use relative units

* fix: update peer dependencies for react-dom

* refactor: clean up auth revalidation logic

* wip: start updating tests for new code changes

* fix: adding missing test case for auth card

* wip: commit progress on auth form test updates

* fix: removal vetigal properties

* fix: get all CoderAuthForm tests passing

* fix: update import for auth hook in test

…130)

* chore: add vendored version of experimental Coder SDK

* fix: improve data hiding for CoderSdk

* docs: update typo

* fix: add additional properties to hide from SDK

* chore: add vendored version of experimental Coder SDK

* chore: update CoderClient class to use new SDK

* chore: delete mock SDK

* fix: improve data hiding for CoderSdk

* docs: update typo

* wip: commit progress on updating Coder client

* wip: commit more progress on updating types

* chore: remove valibot type definitions from global constants file

* chore: rename mocks file

* fix: update type mismatches

* wip: commit more update progress

* wip: commit progress on updating client/SDK integration

* fix: get all tests passing for CoderClient

* fix: update UrlSync updates

* fix: get all tests passing

* chore: update all mock data to use Coder core entity mocks

* fix: add extra helpers to useCoderSdk

* fix: add additional properties to hide from SDK

* fix: shrink down the API of useCoderSdk

* update method name for clarity

* chore: removal vestigal endpoint properties

* chore: add vendored version of experimental Coder SDK

* chore: update CoderClient class to use new SDK

* chore: delete mock SDK

* fix: improve data hiding for CoderSdk

* docs: update typo

* wip: commit progress on updating Coder client

* wip: commit more progress on updating types

* chore: remove valibot type definitions from global constants file

* chore: rename mocks file

* fix: update type mismatches

* wip: commit more update progress

* wip: commit progress on updating client/SDK integration

* fix: get all tests passing for CoderClient

* fix: update UrlSync updates

* fix: get all tests passing

* chore: update all mock data to use Coder core entity mocks

* fix: add extra helpers to useCoderSdk

* fix: add additional properties to hide from SDK

* fix: shrink down the API of useCoderSdk

* update method name for clarity

* chore: removal vestigal endpoint properties

* fix: update reversion

* chore: add vendored version of experimental Coder SDK

* chore: update CoderClient class to use new SDK

* chore: delete mock SDK

* fix: improve data hiding for CoderSdk

* docs: update typo

* wip: commit progress on updating Coder client

* wip: commit more progress on updating types

* chore: remove valibot type definitions from global constants file

* chore: rename mocks file

* fix: update type mismatches

* wip: commit more update progress

* wip: commit progress on updating client/SDK integration

* fix: get all tests passing for CoderClient

* fix: update UrlSync updates

* fix: get all tests passing

* chore: update all mock data to use Coder core entity mocks

* refactor: improve co-location for useCoderWorkspacesQuery

* wip: commit progress on React Query wrappers

* fix: add extra helpers to useCoderSdk

* wip: add test stubs for useCoderQuery

* fix: add queryKey patching to useCoderQuery

* fix: only add queryKey prefix if it is missing

* fix: make Coder query key prefix an opaque string

* refactor: improve ergonomics of useCoderQuery

* refactor: clean up query key patching logic

* chore: let users disable fallback auth UI

* wip: commit progress on tests

* chore: update wording for clarity

* fix: update import for workspaces card root

* chore: get first test passing

* chore: add inverted promise helper

* fix: make non-authenticated queries fail faster

* fix: update tests to make setup easier

* wip: get another test passing

* chore: finish all initial tests for useCoderQuery

* fix: tighten up types for inverted promises

* fix: more tightening

* fix: make sure queries aren't tried indefinitely by default

* wip: commit docs progress

* fix: increase granularity for auth fallback behavior

* wip: commit more docs progress

* fix: establish better boundaries between hooks

* wip: commit more progress

* wip: more docs progress

* fix: split up auth fallback logic into three providers

* fix: update example code

* wip: commit more progress

* fix: update names for auth fallback modes

* wip: more progress

* fix: remove repetitive wording

* wip: more progress

* fix: add table of contents header

* fix: improve granularity of expired token spy logic

* fix: prevent infinite revalidation loop

* fix: clean up the cleanup logic

* fix: update example code

* fix: update header levels

* fix: make prop optional

* chore: add warning about query client mistakes

* wip: finish last code example

* fix: update union/intersection mismatch

* chore: finish initial version of SDK readme

* wip: make placeholders more obvious

* fix: add additional properties to hide from SDK

* fix: shrink down the API of useCoderSdk

* update method name for clarity

* chore: removal vestigal endpoint properties

* fix: swap public 'SDK' usage with 'API'

* fix: remove temp import

* fix: update exports for end-types

* fix: update query wrapper tests

* wip: commit current rewrite progress

* fix: update structure of directory readme

* wip: commit more docs progress

* chore: finish second draft of main README

* refactor: rename ejectToken to unlinkToken

* refactor: reorganize readme file structure

* update details for new versions of README

* chore: delete first draft of the README

* fix: remove duplicate destructuring

* fix: update duplicate exports

* fix: update semver message

* fix: remove useEffect comparison column

* fix: move custom query client into advanced section

* fix: remove redundant examples

* fix: update hook overview

* fix: update formatting for advanced file

* fix: regorganize prefix section

* chore: finish v3 of reorganization

* chore: reorganize text content one last time

* chore: group prefix examples

* chore: reorganize directory readme

* chore: add image of auth fallback

* chore: add video of auth functionality

* docs: fix subtitle for catalog-info description

* docs: fix incorrect reference