microfe-auth

Part of the Burdenoff platform by AlgoShred.

Getting Started

See AGENTS.md for development commands and architecture details.

Shell imports

Hosts that only need auth state or context-switcher hooks can use the public shell entries without statically importing auth routes and challenge UI:

import { useAuthStore } from '@burdenoff/microfe-auth/store';
import {
  useContextSwitcherData,
  useWorkspaceSyncEffect,
  useProjectSyncEffect,
} from '@burdenoff/microfe-auth/shell';

These entries re-export the same canonical store and hooks as the root entry; they do not create another store, change context loading, or defer logout cleanup. The root entry and its existing exports remain supported. Both new entries ship declarations, and the build checks their packed static graph. Consumers must adopt a published package version containing these exports; source-linked tests alone are not a published compatibility guarantee.

Workspace and project selection

The shared context switcher issues a workspace token and reads myProjects to show projects accessible to the current actor. An empty list is a valid workspace-only context: learners and other workspace members do not need create:project permission to open a product. Switching or restoring context never creates a project. Default project provisioning belongs to workspace creation; deliberate project creation remains a separate authorized action.

An empty successful response is retained for the current account and workspace to avoid repeated fetches. Changing accounts or resetting the project list causes a fresh read. Existing projects may still be selected automatically unless the user explicitly chose workspace-wide scope.

License

Proprietary — Copyright Burdenoff Consultancy Services Pvt. Ltd.