@coderic/dashboard-core

Shared dashboard utilities: Auth0 env factory, fetch client, JWT claim helpers.

No branding, Auth0 client IDs, or claim URIs are hardcoded. The consuming app must supply them.

Install

npm install @coderic/dashboard-core @coderic/acl

GitHub Packages:

@coderic:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}

Repo: https://github.com/Coderic/coderic-dashboard-core

Depends on @coderic/acl for ClaimsConfig types and claim parsing.

Exports

Symbol	Purpose
createEnv	Build DashboardEnv from explicit Auth0 config + optional Vite env
createClaimsConfig	{ rolesClaim, permissionsClaim } for JWT namespaces
createAuthHelpers	Role/permission helpers bound to a ClaimsConfig
configureApiClient	Set base URL / auth headers from DashboardEnv
apiFetch	Authenticated JSON fetch wrapper

Usage

import{createEnv,createClaimsConfig,createAuthHelpers,configureApiClient,apiFetch,}from"@coderic/dashboard-core";exportconstclaimsConfig=createClaimsConfig("https://coderic.org/roles","https://coderic.org/permissions",);constAUTH0_CLIENT_IDS={foundation: "YOUR_FOUNDATION_SPA_CLIENT_ID",corporate: "YOUR_CORPORATE_SPA_CLIENT_ID",}asconst;exportconstenv=createEnv({auth0ClientGroup: "corporate",auth0ClientIds: AUTH0_CLIENT_IDS,auth0Domain: "auth.example.com",auth0Audience: "api://my-app",viteEnv: import.meta.env,});configureApiClient(env);constauth=createAuthHelpers(claimsConfig);

createEnv resolution order

1. Explicit args: auth0Domain, auth0ClientId, auth0Audience
2. Vite: VITE_AUTH0_DOMAIN, VITE_AUTH0_CLIENT_ID, VITE_AUTH0_AUDIENCE
3. Client ID via auth0ClientIds[auth0ClientGroup]

Throws if required Auth0 values are missing.

Coderic portal files

dashboard-app/src/config/env.ts → createEnv + portal Auth0 IDs
dashboard-app/src/config/claims.ts → createClaimsConfig(coderic.org URIs)
dashboard-app/src/main.tsx → pass claimsConfig to DashboardRoot

License

MIT