API/API reference
API reference
Every symbol the Angular adapter adds, generated from its source. Three entry points:
| Import from | What it holds |
|---|---|
@qubeejs/angular |
Providers, services, lists, adapters, tokens — and the whole of @qubeejs/core, re-exported |
@qubeejs/angular/router |
provideQubeeRouterAdapter(); the only entry point that needs @angular/router |
@qubeejs/angular/http |
qubeeHttpResource(); built on httpResource(), so it needs Angular 19.2 |
Providers
Section titled “Providers”Configure the driver once, and scope fresh query state where you need it.
buildQubeeProviders()— Build the core provider list shared byprovideQubee()andQubeeModule.forRoot()createQubeeInstance()— Create an isolated query builder, paginator and store, wired togetherprovideQubee()— Sets up providers necessary to enableQubeefunctionality for the applicationprovideQubeeInstance()— Providers for a component-scoped Qubee instanceQubeeModule— NgModule entry point for applications that still bootstrap with modules
Services
Section titled “Services”The injectables: the query builder with its signals, the paginator and the store they share.
QubeePaginator— Parses backend responses into typedPaginatedCollections and syncs the page metadata back into the sharedQubeeSignalStoreQubeeQueryBuilder— The query builder, as an Angular serviceQubeeSignalStore— The query-builder state container, made reactive for Angular
Lists whose state lives in the URL, and the adapters that read and write it.
createQubeeMemoryAdapter()— Create an adapter that keeps a list’s query in memory, out of the address barinjectQubeeList()— A list’s state as a reactive handle, read from the URL and written back to itprovideQubeeBrowserAdapter()— Provide an adapter that reads and writes the address bar through the History API, for an application without the Angular RouterprovideQubeeMemoryAdapter()— Provide a memory adapter to every list under an injectorprovideQubeeRouterAdapter()— Provide an adapter that reads and writes the URL through the Angular Router
Fetching
Section titled “Fetching”Fetching a list page with httpResource(), from @qubeejs/angular/http.
qubeeHttpResource()— Fetch the page a list request asks for, and fetch again when it changesQubeeHttpResourceOptions— Options ofqubeeHttpResourceQubeeHttpResourceRef— WhatqubeeHttpResourcereturns
Tokens
Section titled “Tokens”What provideQubee() registers, for when you need to read or replace one.
QUBEE_BASE_URL— Injection token for the base URL every generated URI starts withQUBEE_DRIVER— Injection token for the active driver definitionQUBEE_LIST_ADAPTER— Injection token for the adapterinjectQubeeList()reads and writes the URL throughQUBEE_REQUEST_OPTIONS— Injection token for the resolved request query-parameter key optionsQUBEE_REQUEST_STRATEGY— Injection token for the resolved request URI strategyQUBEE_RESPONSE_OPTIONS— Injection token for the resolved response field-key optionsQUBEE_RESPONSE_STRATEGY— Injection token for the resolved response parsing strategy
Errors
Section titled “Errors”What the adapter throws on its own.
MissingRouterAdapterError— Thrown byinjectQubeeList()when no adapter is passed and none is provided underQUBEE_LIST_ADAPTER
The types of the adapter’s own API.
QubeeInstance— WhatcreateQubeeInstance()returns: the three Angular objects, already wired together around one private storeQubeeList— WhatinjectQubeeList()returns for a list definitionTListQubeeListAdapter— Where a list reads its URL from and how it writes one backQubeeListArgs— The argumentsinjectQubeeList()takes after the listQubeeListInput— The input a list declares, asinjectQubeeList()takes it: the value, a signal or function returning it, ornullfor “not ready yet”QubeeListNavigateOptions— How a list asks its adapter to navigateQubeeListOptions— Options ofinjectQubeeList()common to every listQubeeListRequest— The value of aQubeeList’srequest: aListRequestfor a list without an input, andListRequest | nullfor a list that declares one —nullwhile its input isnullQubeeListSetOptions— Options ofset()andtoggleSort()on aQubeeListQubeeListSortToggle— ThetoggleSortmember of aQubeeList: present only when the list declares exactly onesortParam, withfieldtyped to the fields it allows