Packages
Packages
Every @cogs/* package that is not a Skill mirror, grouped by what it does. Private packages are marked and are not on npm.
Auth and email
- @cogs/authnpmCanonical JWKS token verification + RBAC role resolution (env role-map + injected DB) for the workloom and fleetworks families
- @cogs/auth-eventsnpmShared device-cookie + salted-hash new-device-login detection and login-completion handling for the workloom family of sites
- @cogs/emailsnpmShared transactional email templates (MJML/EJS) and render core for the workloom family of sites
- @cogs/send-serviceprivateCentral signed transactional-email send service for the workloom family of sites (keeps SES creds out of the apps; not an open relay)
Typed data layer
- @cogs/fetch-clientnpmxior-based HTTP transport for Kubb v5 generated API clients — the single seam where base URL, auth, headers, timeouts and error shape live
- @cogs/react-querynpmThe single TanStack Query seam — re-exports the library plus a shared createQueryClient (centralised retry, 401/403 handling) and stable object-key hashing for Kubb-generated hooks
- @cogs/kubb-transformsnpmjscodeshift-based code transforms for maintaining Kubb v5-generated codegen output
- @cogs/fetch-error-handlernpmProperly handle fetch errors and avoid a lot of boilerplate in your app.
- @cogs/errorsnpmA suite of error classes which help you throw the most appropriate error in any situation
- @cogs/serialize-requestnpmA utility function to serialize a request object in a way that's friendly to loggers, view engines, and converting to JSON
React state helpers
- @cogs/nuqsnpmReusable nuqs (URL search-param state) patterns — table pagination/filter hook factories, page-index conversion, sort/filter parser builders, and typed search-param API helpers.
- @cogs/react-hook-formnpmReact Hook Form helpers — selective dirty/error subscriptions, deep default merging, and controlled-field utilities.
- @cogs/react-tablenpmTanStack React Table helpers — table-state hooks, row-selection utilities, and CSV export.
Config and environment
- @cogs/confignpmFramework-agnostic layered-dotenv loader — resolves the canonical .env file chain, expands ${VAR} references, and folds values into process.env with deploy-injected variables staying authoritative. Dual ESM+CJS so it works from an ESM --import preload or a CJS --require hook (dd-trace and other one-offs)
- @cogs/environmentnpmTyped env registry machinery — a generic factory that turns a per-app variable catalog into a Zod runtime schema, startup validators, and a public-only client snapshot. Ships the framework, not the variable list
- @cogs/env-doctorprivateRender env-var quoted-secret diagnosis and single-key fix — never bulk-replace.
- @cogs/supabase-syncprivateSupabase Management-API config sync tool + sites-registry harvester/driver. Never published — see .changeset/config.json ignore list.
- @cogs/is-dockernpmCheck if the process is running inside a Docker container
- @cogs/node-pkgnpmResolve and spawn a node_modules/.bin binary from a package.json bin field, walking the directory tree up and down — makes hoisted-binary proxy scripts work correctly in a monorepo
Shared tooling config
- @cogs/biome-confignpmShared Biome configuration for the catesworks fleet
- @cogs/eslint-confignpmShared flat ESLint configuration for the catesworks fleet
- @cogs/prettier-confignpmShared Prettier configuration for the catesworks fleet
- @cogs/browserslist-confignpmShareable Browserslist config, plus a utility for computing the lowest supported browser version across a set of Browserslist queries
- @cogs/skills-sitenpmDocusaurus plugin and React components: a skills browser (card grid, category rail, detail dialog, zip download) for skills repos