Glossary

Overview of terms used in the Fragno docs

TermDefinitionArea
DependenciesPrivate server-side objects (like database connections, API clients) available to route handlers but not included in client bundlesCore
FragmentA full-stack library built with Fragno that contains both server-side API logic and client-side integration codeCore
ServicesPublic server-side functions exposed to Fragment users for use in custom handlers or background tasksCore
HooksReact-style functions for reading data from GET routes, created via createHookClient
MutatorsClient-side functions for modifying data through POST/PUT/DELETE routes, created via createMutatorClient
AdaptersFramework-specific integration helpers that convert Fragno's standard handlers to work with specific frameworksServer
Durable HooksSide effects registered during a database transaction that are persisted and executed after commit, with automatic retries on failureDatabase
FragnoIdA type that carries both ID and version information, used for optimistic concurrency control in database operationsDatabase
Optimistic Concurrency ControlA concurrency control method that uses version checking to detect conflicts, automatically retrying transactions when conflicts occurDatabase
Transaction / UOWA two-phase Unit of Work pattern where reads and writes are batched together and executed atomically, enabling composition across multiple servicesDatabase
Tx BuilderA fluent API (serviceTx, handlerTx) for defining and executing transactions with methods like .retrieve(), .mutate(), .transform(), and .execute()Database
Code SplittingAutomatic separation of client and server code during build time, removing server-side dependencies from client bundlesBuild
UnpluginA unified plugin system that supports Vite, Rollup, webpack, and other build tools, used by fragment authors through the @fragno-dev/unplugin-fragno packageBuild