fireflyframework · mfg1986 · May 20, 2026 · May 20, 2026 · May 20, 2026 · May 20, 2026
diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.11.0] - 2026-05-20
+
+### Changed
+- **BREAKING:** All 16 services now require explicit registration via `provideX()` factory functions
+- Removed `providedIn: 'root'` from 12 services: ErrorService, FeatureFlagService, NavigationService, BreadcrumbService, PermissionService, AlertService, MasterDataService, TransportRegistry, ApiClient, AuthService, UserContextService, SessionService
+- Updated 7 existing factories to register their service class (provideErrorHandling, provideFeatureFlags, provideNavigation, providePermissions, provideAlerts, provideMasterData, provideFireflyTransport)
+
+### Added
+- `provideAuth()` — factory for AuthService registration
+- `provideSession(config?)` — factory for SessionService registration (accepts optional `SessionTimeoutConfig`)
+- `provideBreadcrumb()` — factory for BreadcrumbService registration
+- `provideApiClient()` — factory for ApiClient registration
+- `provideUserContext()` — factory for UserContextService registration
+
+### Migration
+- Applications MUST add `provideAuth()`, `provideSession()`, `provideBreadcrumb()`, `provideApiClient()`, and `provideUserContext()` to their `app.config.ts` providers
+- Tests that inject services directly MUST include the corresponding `provideX()` in `TestBed.configureTestingModule({ providers: [...] })`
+
 ## [0.10.1] - 2026-05-20
 
 ### Added
@@ -154,7 +172,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - User context module: `UserContextService`
 - API runtime module: `ApiClient`, `TransportRegistry`, `HttpTransportAdapter`
 
-[Unreleased]: https://github.com/fireflyframework/firefly-frontend-framework/compare/core@0.10.0...HEAD
+[Unreleased]: https://github.com/fireflyframework/firefly-frontend-framework/compare/core@0.11.0...HEAD
+[0.11.0]: https://github.com/fireflyframework/firefly-frontend-framework/compare/core@0.10.1...core@0.11.0
 [0.10.0]: https://github.com/fireflyframework/firefly-frontend-framework/compare/core@0.9.0...core@0.10.0
 [0.9.0]: https://github.com/fireflyframework/firefly-frontend-framework/compare/core@0.8.0...core@0.9.0
 [0.8.0]: https://github.com/fireflyframework/firefly-frontend-framework/compare/core@0.7.2...core@0.8.0

diff --git a/packages/core/package.json b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@fireflyframework/core",
-  "version": "0.10.1",
+  "version": "0.11.0",
   "publishConfig": {
     "registry": "https://npm.pkg.github.com"
   },

diff --git a/packages/core/src/lib/alerts/alert.service.spec.ts b/packages/core/src/lib/alerts/alert.service.spec.ts
@@ -1,12 +1,13 @@
 import { TestBed } from '@angular/core/testing';
 import { AlertService } from './alert.service';
+import { provideAlerts } from './provide-alerts';
 
 describe('AlertService — toasts & banners', () => {
   let service: AlertService;
 
   beforeEach(() => {
     vi.useFakeTimers();
-    TestBed.configureTestingModule({});
+    TestBed.configureTestingModule({ providers: [provideAlerts()] });
     service = TestBed.inject(AlertService);
   });
 

diff --git a/packages/core/src/lib/alerts/alert.service.ts b/packages/core/src/lib/alerts/alert.service.ts
@@ -56,7 +56,7 @@ const MAX_VISIBLE_BANNERS = 3;
  * // @for (toast of alerts.activeToasts(); track toast.id) { ... }
  * ```
  */
-@Injectable({ providedIn: 'root' })
+@Injectable()
 export class AlertService {
   private readonly _toasts = signal<Toast[]>([]);
   private readonly _banners = signal<Banner[]>([]);

diff --git a/packages/core/src/lib/alerts/provide-alerts.ts b/packages/core/src/lib/alerts/provide-alerts.ts
@@ -4,6 +4,7 @@ import {
   makeEnvironmentProviders,
 } from '@angular/core';
 import { AlertConfig } from './alert.types';
+import { AlertService } from './alert.service';
 
 /**
  * Injection token for optional alert configuration.
@@ -36,6 +37,7 @@ export function provideAlerts(
   config?: AlertConfig,
 ): EnvironmentProviders {
   return makeEnvironmentProviders([
+    AlertService,
     ...(config ? [{ provide: ALERT_CONFIG, useValue: config }] : []),
   ]);
 }
diff --git a/packages/core/src/lib/api-runtime/api-client.service.spec.ts b/packages/core/src/lib/api-runtime/api-client.service.spec.ts
@@ -5,6 +5,8 @@ import { TransportRegistry } from './transport/transport-registry';
 import { TransportAdapter } from './transport/transport-adapter';
 import { TransportError } from './transport/transport-error';
 import { TransportProtocol, TransportRequest, TransportResponse } from './transport/transport-request';
+import { provideApiClient } from './provide-api-client';
+import { provideFireflyTransport } from './provide-firefly-transport';
 
 /** Minimal mock adapter for testing */
 class MockTransportAdapter extends TransportAdapter {
@@ -29,7 +31,7 @@ describe('ApiClient', () => {
   let mockAdapter: MockTransportAdapter;
 
   beforeEach(() => {
-    TestBed.configureTestingModule({});
+    TestBed.configureTestingModule({ providers: [provideApiClient(), provideFireflyTransport({ defaultProtocol: 'http', routes: [] })] });
     apiClient = TestBed.inject(ApiClient);
     registry = TestBed.inject(TransportRegistry);
 

diff --git a/packages/core/src/lib/api-runtime/api-client.service.ts b/packages/core/src/lib/api-runtime/api-client.service.ts
@@ -24,7 +24,7 @@ import { TransportError } from './transport/transport-error';
  * - Retry (that's RetryInterceptor cross-protocol, G14)
  * - Handle auth headers (that's SecurityInterceptor)
  */
-@Injectable({ providedIn: 'root' })
+@Injectable()
 export class ApiClient {
   private readonly registry = inject(TransportRegistry);
 

diff --git a/packages/core/src/lib/api-runtime/index.ts b/packages/core/src/lib/api-runtime/index.ts
@@ -2,3 +2,4 @@ export * from './transport';
 export * from './adapters/http';
 export { ApiClient } from './api-client.service';
 export { provideFireflyTransport } from './provide-firefly-transport';
+export { provideApiClient } from './provide-api-client';
diff --git a/packages/core/src/lib/api-runtime/provide-api-client.ts b/packages/core/src/lib/api-runtime/provide-api-client.ts
@@ -0,0 +1,6 @@
+import { makeEnvironmentProviders, EnvironmentProviders } from '@angular/core';
+import { ApiClient } from './api-client.service';
+
+export function provideApiClient(): EnvironmentProviders {
+  return makeEnvironmentProviders([ApiClient]);
+}
diff --git a/packages/core/src/lib/api-runtime/provide-firefly-transport.ts b/packages/core/src/lib/api-runtime/provide-firefly-transport.ts
@@ -24,6 +24,7 @@ import { TRANSPORT_OPTIONS } from './transport/retry.interceptor';
  */
 export function provideFireflyTransport(config: TransportConfig): EnvironmentProviders {
   return makeEnvironmentProviders([
+    TransportRegistry,
     ...(config.options ? [{ provide: TRANSPORT_OPTIONS, useValue: config.options }] : []),
     provideEnvironmentInitializer(() => {
       const registry = inject(TransportRegistry);

diff --git a/packages/core/src/lib/api-runtime/transport/transport-registry.spec.ts b/packages/core/src/lib/api-runtime/transport/transport-registry.spec.ts
@@ -4,6 +4,7 @@ import { TransportAdapter } from './transport-adapter';
 import { TransportError } from './transport-error';
 import { TransportProtocol, TransportRequest, TransportResponse } from './transport-request';
 import { TransportRoute } from './transport-route';
+import { provideFireflyTransport } from '../provide-firefly-transport';
 
 /** Minimal mock adapter for testing */
 class MockTransportAdapter extends TransportAdapter {
@@ -30,7 +31,7 @@ describe('TransportRegistry', () => {
   let registry: TransportRegistry;
 
   beforeEach(() => {
-    TestBed.configureTestingModule({});
+    TestBed.configureTestingModule({ providers: [provideFireflyTransport({ defaultProtocol: 'http', routes: [] })] });
     registry = TestBed.inject(TransportRegistry);
   });
 

diff --git a/packages/core/src/lib/api-runtime/transport/transport-registry.ts b/packages/core/src/lib/api-runtime/transport/transport-registry.ts
@@ -22,7 +22,7 @@ import { TransportRoute, ResolvedTransport } from './transport-route';
  * configuration and adapters are registered in the providers.
  * No dynamic re-routing at runtime.
  */
-@Injectable({ providedIn: 'root' })
+@Injectable()
 export class TransportRegistry {
   /** Configured routes — loaded from firefly.config.yaml by provideFireflyTransport() */
   private readonly routes = signal<TransportRoute[]>([]);

diff --git a/packages/core/src/lib/auth/auth.service.spec.ts b/packages/core/src/lib/auth/auth.service.spec.ts
@@ -11,6 +11,9 @@ import { AuthService } from './auth.service';
 import { AuthTokens } from './auth.types';
 import { SessionService } from '../session/session.service';
 import { UserContextService } from '../user-context/user-context.service';
+import { provideAuth } from './provide-auth';
+import { provideSession } from '../session/provide-session';
+import { provideUserContext } from '../user-context/provide-user-context';
 
 const API = '/api/v1/experience/security';
 
@@ -47,6 +50,9 @@ describe('AuthService', () => {
 
     TestBed.configureTestingModule({
       providers: [
+        provideAuth(),
+        provideSession(),
+        provideUserContext(),
         provideHttpClient(withInterceptorsFromDi()),
         provideHttpClientTesting(),
       ],

diff --git a/packages/core/src/lib/auth/auth.service.ts b/packages/core/src/lib/auth/auth.service.ts
@@ -21,7 +21,7 @@ const AUTH_API_BASE = '/api/v1/experience/security';
  *
  * API base: /api/v1/experience/security (exp-security microservice)
  */
-@Injectable({ providedIn: 'root' })
+@Injectable()
 export class AuthService {
   /** Reactive signal indicating whether the user is currently authenticated. */
   readonly isAuthenticated = signal(false);

diff --git a/packages/core/src/lib/auth/guards/auth.guard.spec.ts b/packages/core/src/lib/auth/guards/auth.guard.spec.ts
@@ -5,6 +5,9 @@ import { provideHttpClientTesting } from '@angular/common/http/testing';
 import { Component } from '@angular/core';
 import { authGuard } from './auth.guard';
 import { AuthService } from '../auth.service';
+import { provideAuth } from '../provide-auth';
+import { provideSession } from '../../session/provide-session';
+import { provideUserContext } from '../../user-context/provide-user-context';
 
 @Component({ template: '', standalone: true })
 class DummyComponent {}
@@ -18,6 +21,9 @@ describe('authGuard', () => {
 
     TestBed.configureTestingModule({
       providers: [
+        provideAuth(),
+        provideSession(),
+        provideUserContext(),
         provideHttpClient(),
         provideHttpClientTesting(),
         provideRouter([

diff --git a/packages/core/src/lib/auth/index.ts b/packages/core/src/lib/auth/index.ts
@@ -2,3 +2,4 @@ export { AuthService } from './auth.service';
 export { authInterceptor } from './interceptors/auth.interceptor';
 export { authGuard } from './guards/auth.guard';
 export type { LoginCredentials, AuthTokens, AuthResult } from './auth.types';
+export { provideAuth } from './provide-auth';
diff --git a/packages/core/src/lib/auth/interceptors/auth.interceptor.spec.ts b/packages/core/src/lib/auth/interceptors/auth.interceptor.spec.ts
@@ -9,6 +9,9 @@ import {
   provideHttpClientTesting,
 } from '@angular/common/http/testing';
 import { authInterceptor } from './auth.interceptor';
+import { provideAuth } from '../provide-auth';
+import { provideSession } from '../../session/provide-session';
+import { provideUserContext } from '../../user-context/provide-user-context';
 
 /** Flush Promise microtask queue so async interceptor logic completes. */
 const flushMicrotasks = () => new Promise((r) => setTimeout(r, 0));
@@ -22,6 +25,9 @@ describe('authInterceptor', () => {
 
     TestBed.configureTestingModule({
       providers: [
+        provideAuth(),
+        provideSession(),
+        provideUserContext(),
         provideHttpClient(withInterceptors([authInterceptor])),
         provideHttpClientTesting(),
       ],

diff --git a/packages/core/src/lib/auth/provide-auth.ts b/packages/core/src/lib/auth/provide-auth.ts
@@ -0,0 +1,6 @@
+import { makeEnvironmentProviders, EnvironmentProviders } from '@angular/core';
+import { AuthService } from './auth.service';
+
+export function provideAuth(): EnvironmentProviders {
+  return makeEnvironmentProviders([AuthService]);
+}
diff --git a/packages/core/src/lib/error-handling/error.interceptor.spec.ts b/packages/core/src/lib/error-handling/error.interceptor.spec.ts
@@ -10,6 +10,7 @@ import {
 } from '@angular/common/http/testing';
 import { errorInterceptor } from './error.interceptor';
 import { ErrorService } from './error.service';
+import { provideErrorHandling } from './provide-error-handling';
 
 describe('errorInterceptor', () => {
   let http: HttpClient;
@@ -19,6 +20,7 @@ describe('errorInterceptor', () => {
   beforeEach(() => {
     TestBed.configureTestingModule({
       providers: [
+        provideErrorHandling(),
         provideHttpClient(withInterceptors([errorInterceptor])),
         provideHttpClientTesting(),
       ],

diff --git a/packages/core/src/lib/error-handling/error.service.spec.ts b/packages/core/src/lib/error-handling/error.service.spec.ts
@@ -2,12 +2,13 @@ import { TestBed } from '@angular/core/testing';
 import { ErrorService, ERROR_HANDLING_CONFIG } from './error.service';
 import { createAppError } from './app-error';
 import type { AppError } from './app-error';
+import { provideErrorHandling } from './provide-error-handling';
 
 describe('ErrorService', () => {
   let service: ErrorService;
 
   beforeEach(() => {
-    TestBed.configureTestingModule({});
+    TestBed.configureTestingModule({ providers: [provideErrorHandling()] });
     service = TestBed.inject(ErrorService);
   });
 
@@ -106,7 +107,7 @@ describe('ErrorService with custom config', () => {
   beforeEach(() => {
     TestBed.configureTestingModule({
       providers: [
-        { provide: ERROR_HANDLING_CONFIG, useValue: { maxHistorySize: 3 } },
+        provideErrorHandling({ maxHistorySize: 3 }),
       ],
     });
     service = TestBed.inject(ErrorService);

diff --git a/packages/core/src/lib/error-handling/error.service.ts b/packages/core/src/lib/error-handling/error.service.ts
@@ -35,7 +35,7 @@ export const ERROR_HANDLING_CONFIG = new InjectionToken<{ maxHistorySize?: numbe
  * this.errors.clearError();
  * ```
  */
-@Injectable({ providedIn: 'root' })
+@Injectable()
 export class ErrorService {
   private readonly config = inject(ERROR_HANDLING_CONFIG, { optional: true });
 

diff --git a/packages/core/src/lib/error-handling/firefly-error-handler.spec.ts b/packages/core/src/lib/error-handling/firefly-error-handler.spec.ts
@@ -2,6 +2,7 @@ import { TestBed } from '@angular/core/testing';
 import { HttpErrorResponse } from '@angular/common/http';
 import { FireflyErrorHandler } from './firefly-error-handler';
 import { ErrorService } from './error.service';
+import { provideErrorHandling } from './provide-error-handling';
 
 describe('FireflyErrorHandler', () => {
   let handler: FireflyErrorHandler;
@@ -10,7 +11,7 @@ describe('FireflyErrorHandler', () => {
 
   beforeEach(() => {
     TestBed.configureTestingModule({
-      providers: [FireflyErrorHandler],
+      providers: [provideErrorHandling(), FireflyErrorHandler],
     });
 
     handler = TestBed.inject(FireflyErrorHandler);

diff --git a/packages/core/src/lib/error-handling/provide-error-handling.ts b/packages/core/src/lib/error-handling/provide-error-handling.ts
@@ -4,7 +4,7 @@ import {
   makeEnvironmentProviders,
 } from '@angular/core';
 import type { ErrorHandlingConfig } from './app-error';
-import { ERROR_HANDLING_CONFIG } from './error.service';
+import { ErrorService, ERROR_HANDLING_CONFIG } from './error.service';
 import { FireflyErrorHandler } from './firefly-error-handler';
 
 /**
@@ -36,6 +36,7 @@ export function provideErrorHandling(
   config?: ErrorHandlingConfig,
 ): EnvironmentProviders {
   return makeEnvironmentProviders([
+    ErrorService,
     { provide: ErrorHandler, useClass: FireflyErrorHandler },
     ...(config ? [{ provide: ERROR_HANDLING_CONFIG, useValue: config }] : []),
   ]);

diff --git a/packages/core/src/lib/feature-flags/feature-flag.directive.spec.ts b/packages/core/src/lib/feature-flags/feature-flag.directive.spec.ts
@@ -2,6 +2,7 @@ import { Component } from '@angular/core';
 import { ComponentFixture, TestBed } from '@angular/core/testing';
 import { FfFeatureFlagDirective } from './feature-flag.directive';
 import { FeatureFlagService } from './feature-flag.service';
+import { provideFeatureFlags } from './provide-feature-flags';
 
 @Component({
   template: `<span *ffFeatureFlag="'new-dashboard'">Visible</span>`,
@@ -17,6 +18,7 @@ describe('FfFeatureFlagDirective', () => {
   beforeEach(() => {
     TestBed.configureTestingModule({
       imports: [TestHostComponent],
+      providers: [provideFeatureFlags()],
     });
 
     service = TestBed.inject(FeatureFlagService);

diff --git a/packages/core/src/lib/feature-flags/feature-flag.service.spec.ts b/packages/core/src/lib/feature-flags/feature-flag.service.spec.ts
@@ -1,11 +1,12 @@
 import { TestBed } from '@angular/core/testing';
 import { FeatureFlagService, FEATURE_FLAG_CONFIG } from './feature-flag.service';
+import { provideFeatureFlags } from './provide-feature-flags';
 
 describe('FeatureFlagService', () => {
   let service: FeatureFlagService;
 
   beforeEach(() => {
-    TestBed.configureTestingModule({});
+    TestBed.configureTestingModule({ providers: [provideFeatureFlags()] });
     service = TestBed.inject(FeatureFlagService);
   });
 
@@ -338,10 +339,7 @@ describe('FeatureFlagService with config', () => {
   it('should load defaults from injected config', () => {
     TestBed.configureTestingModule({
       providers: [
-        {
-          provide: FEATURE_FLAG_CONFIG,
-          useValue: { defaults: { 'pre-loaded': true } },
-        },
+        provideFeatureFlags({ defaults: { 'pre-loaded': true } }),
       ],
     });
 

diff --git a/packages/core/src/lib/feature-flags/feature-flag.service.ts b/packages/core/src/lib/feature-flags/feature-flag.service.ts
@@ -32,7 +32,7 @@ export const FEATURE_FLAG_CONFIG = new InjectionToken<FeatureFlagConfig>(
  * await flags.loadFlags('firebase');
  * ```
  */
-@Injectable({ providedIn: 'root' })
+@Injectable()
 export class FeatureFlagService {
   private readonly _flags = signal<Map<string, boolean>>(new Map());
   private readonly _computedCache = new Map<string, Signal<boolean>>();

diff --git a/packages/core/src/lib/feature-flags/provide-feature-flags.ts b/packages/core/src/lib/feature-flags/provide-feature-flags.ts
@@ -1,6 +1,6 @@
 import { EnvironmentProviders, makeEnvironmentProviders } from '@angular/core';
 import type { FeatureFlagConfig } from './feature-flag.types';
-import { FEATURE_FLAG_CONFIG } from './feature-flag.service';
+import { FeatureFlagService, FEATURE_FLAG_CONFIG } from './feature-flag.service';
 
 /**
  * Configure the feature-flags module.
@@ -27,6 +27,7 @@ export function provideFeatureFlags(
   config?: FeatureFlagConfig,
 ): EnvironmentProviders {
   return makeEnvironmentProviders([
+    FeatureFlagService,
     ...(config
       ? [{ provide: FEATURE_FLAG_CONFIG, useValue: config }]
       : []),