@mis-wis/common 0.2.0 → 0.2.1

package/lib/services/session.errors.d.ts

@@ -13,3 +13,19 @@ export declare class SessionClaimNotFoundError extends SessionError {
     readonly claim: string;
     constructor(claim: string);
 }
+export declare type SessionClaimFailureReason = 'absent' | 'blank';
+export interface ISessionClaimFailure {
+    claim: string;
+    reason: SessionClaimFailureReason;
+}
+/** Renders failures as `claim (reason), claim (reason)` for error messages. */
+export declare function describeClaimFailures(failures: ISessionClaimFailure[]): string;
+/**
+ * Every claim `run`'s `next` failed to read, reported once after the block has finished.
+ * Extends `SessionClaimNotFoundError` — and reports the first failure as `claim` — so handlers
+ * written against the single-claim error keep working.
+ */
+export declare class SessionClaimsMissingError extends SessionClaimNotFoundError {
+    readonly failures: ISessionClaimFailure[];
+    constructor(failures: ISessionClaimFailure[]);
+}

package/lib/services/session.service.d.ts

@@ -1,10 +1,21 @@
 import { NsSession } from '../models/session.model';
 import { SessionError } from './session.errors';
 import * as i0 from "@angular/core";
+/** The accessors that read a single claim, and so can come back `undefined` inside `run`. */
+declare type ClaimAccessor = 'sub' | 'empGuid' | 'employeeId' | 'internalSsoRole' | 'roles' | 'sessionId' | 'loggedInUser' | 'exp' | 'iat' | 'businessUnitId' | 'allowedBuids' | 'vetUserEmailId' | 'vetUserId' | 'source' | 'roleId';
+/**
+ * The session as seen inside `run`'s `next`. `run` collects missing claims instead of throwing
+ * so the block always completes, which means any claim accessor may yield `undefined`.
+ * Outside `run` — direct access, or `read` — the accessors still throw and stay non-optional.
+ */
+export declare type PartialSession = Omit<SessionService, ClaimAccessor> & {
+    readonly [K in ClaimAccessor]: SessionService[K] | undefined;
+};
 export declare class SessionService {
     private config;
     private cachedToken;
     private cachedState;
+    private collecting;
     init(config: NsSession.IInitConfig): void;
     /**
      * Runs `handlers.next` and returns its result, or `handlers.error(error)` if it throws a `SessionError`.
@@ -16,14 +27,27 @@ export declare class SessionService {
     }): T;
     /**
      * Statement-style variant of `read` for blocks of assignments/side effects with no return value.
+     *
+     * `next` always runs to completion: a claim that is absent or blank yields `undefined` instead of
+     * throwing, and every such failure is reported once afterwards via `handlers.error`, as a
+     * `SessionClaimsMissingError` listing all of them. An unusable token (missing, expired,
+     * undecodable) still aborts `next` immediately with the matching `SessionError`.
+     *
+     * Collecting covers the synchronous body of `next` only — claim reads deferred into a subscription,
+     * timeout or promise run after it has returned and throw as usual.
+     *
+     * An error `next` throws for any other reason propagates untouched, except that any claims missing
+     * at the time are appended to its message and attached as `sessionClaimFailures` — a collected
+     * `undefined` reaching the block is the usual cause, and that is the part worth knowing.
      */
     run(handlers: {
-        next: (session: SessionService) => void;
+        next: (session: PartialSession) => void;
         error: (error: SessionError) => void;
     }): void;
     get isVET(): boolean;
     get sub(): string;
     get empGuid(): string;
+    get employeeId(): string;
     get internalSsoRole(): string;
     get roles(): string[];
     get sessionId(): string;
@@ -36,8 +60,13 @@ export declare class SessionService {
     get vetUserId(): number;
     get source(): string;
     get roleId(): number;
+    /** First numeric role in `internal_sso_role` then `roles`, or `''` when the token carries none. */
+    private resolveRole;
+    private isDigitsOnly;
     private getClaims;
     private getClaim;
+    /** Records the failure and yields `undefined` while `run` is collecting; throws otherwise. */
+    private missingClaim;
     private get state();
     private build;
     private isExpired;
@@ -47,3 +76,4 @@ export declare class SessionService {
     static ɵfac: i0.ɵɵFactoryDeclaration<SessionService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<SessionService>;
 }
+export {};

package/package.json

@@ -1,11 +1,16 @@
 {
   "name": "@mis-wis/common",
   "main": "src/public-api.ts",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "peerDependencies": {
+    "@angular/cdk": "*",
     "@angular/common": "*",
     "@angular/core": "*",
-    "mis-crystal-design-system": "*"
+    "@angular/forms": "*",
+    "@angular/router": "*",
+    "dayjs": "^1.11.0",
+    "mis-crystal-design-system": "*",
+    "rxjs": "*"
   },
   "dependencies": {
     "tslib": "^2.0.0",