@paulo-studio/oauth

OAuth integration package for Paulo Portal Angular applications.

Install

npm install @paulo-studio/oauth

Peer dependencies

Peer dependencies are declared in package.json. Install matching Angular 19, PrimeNG 19, and any listed @paulo-studio/* peer packages in the consuming app.

Existing notes

OAuth2 / OpenID Connect (OIDC) integration cho Paulo Portal — concrete implementation overrides the stubs ở @paulo-studio/core (AuthService, authGuard, ApiInterceptor.getAdditionalHeaders).

Mirror của @abp/ng.oauth, adapted cho Paulo (Angular 19 NgModule pattern, PrimeNG, non-SSR SPA).

Strategy

• Authorization Code Flow + PKCE (default).
• MemoryTokenStorageService (SharedWorker cross-tab + in-memory fallback) — tránh localStorage XSS surface.
• Wire trong app qua providePauloOAuth() EnvironmentProviders.

Quick start

import { providePauloOAuth } from '@paulo-studio/oauth';

@NgModule({
  providers: [
    providePauloHttp(),
    providePauloCore({ environment, ... }),
    providePauloOAuth(),                     // ← AFTER providePauloCore, BEFORE providePauloRouting
    providePauloRouting({ ... }),
  ],
})
export class AppModule {}

Apply asyncPauloAuthGuard lên root route để gate authenticated areas:

{
  path: '',
  component: DynamicLayoutComponent,
  canActivate: [asyncPauloAuthGuard],
  children: [...],
}

License

Licensed under AGPL-3.0-only. Commercial licensing is available separately.