@mudrichenkoevgeny/web-platform-sdk-core-security 0.0.1 → 0.1.0

package/dist/di/security-component.d.ts

@@ -0,0 +1,56 @@
+import { EncryptedSettings, HttpClient, WebSocketService } from '@mudrichenkoevgeny/web-platform-sdk-core-common';
+import { PasswordPolicyValidator } from '@mudrichenkoevgeny/shared-foundation';
+import { OpenSecuritySettingsStorage } from '../storage/security-settings/open-security-settings-storage';
+import { OpenSecuritySettingsApi } from '../network/api/security-settings/open-security-settings-api';
+import { OpenSecuritySettingsRepository } from '../repository/open-security-settings-repository';
+import { RefreshOpenSecuritySettingsUseCase } from '../usecase/refresh-open-security-settings-use-case';
+import { ObserveOpenSecuritySettingsUseCase } from '../usecase/observe-open-security-settings-use-case';
+import { ValidatePasswordUseCase } from '../usecase/validate-password-use-case';
+import { SecurityWebSocketMessageHandler } from '../network/websocket/message-handler/security-web-socket-message-handler';
+/**
+ * Configuration options required to instantiate {@link SecurityComponent}.
+ */
+export interface SecurityComponentConfig {
+    /** Global WebSocket service. */
+    webSocketService: WebSocketService;
+    /** Pre-configured HTTP client for REST calls. */
+    httpClient: HttpClient;
+    /** Encrypted storage backend. */
+    encryptedSettings: EncryptedSettings;
+    /** Optional mock overrides for tests. */
+    openSecuritySettingsApi?: OpenSecuritySettingsApi;
+    /** Optional mock overrides for tests. */
+    openSecuritySettingsStorage?: OpenSecuritySettingsStorage;
+    /** Optional mock overrides for tests. */
+    passwordPolicyValidator?: PasswordPolicyValidator;
+}
+/**
+ * Root dependency injection container for `core-security` module.
+ *
+ * Assembles storage, networking, repositories, and password policy validation.
+ */
+export declare class SecurityComponent {
+    /** Core persistence interface for open security settings. */
+    readonly securitySettingsStorage: OpenSecuritySettingsStorage;
+    /** HTTP REST client API for open security settings. */
+    readonly openSecuritySettingsApi: OpenSecuritySettingsApi;
+    /** Central repository for open security settings. */
+    readonly securitySettingsRepository: OpenSecuritySettingsRepository;
+    /** Pure domain logic password policy validator from shared foundation. */
+    readonly passwordPolicyValidator: PasswordPolicyValidator;
+    /** Use case for forcing a network refresh of settings. */
+    readonly refreshSecuritySettingsUseCase: RefreshOpenSecuritySettingsUseCase;
+    /** Use case for observing live open security settings changes. */
+    readonly observeOpenSecuritySettingsUseCase: ObserveOpenSecuritySettingsUseCase;
+    /** Use case for validating password candidate strings against active policy. */
+    readonly validatePasswordUseCase: ValidatePasswordUseCase;
+    /** Handler offered to the shared WebSocket pipeline. */
+    readonly securityWebSocketMessageHandler: SecurityWebSocketMessageHandler;
+    /**
+     * Constructs a new {@link SecurityComponent}.
+     *
+     * @param config - Container configuration holding global SDK dependencies
+     */
+    constructor(config: SecurityComponentConfig);
+}
+//# sourceMappingURL=security-component.d.ts.map

package/dist/di/security-component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security-component.d.ts","sourceRoot":"","sources":["../../src/di/security-component.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iDAAiD,CAAA;AACtH,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAA;AAC9E,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,6DAA6D,CAAA;AAE9G,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6DAA6D,CAAA;AAE1G,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,iDAAiD,CAAA;AAErG,OAAO,EAAE,kCAAkC,EAAE,MAAM,oDAAoD,CAAA;AACvG,OAAO,EAAE,kCAAkC,EAAE,MAAM,oDAAoD,CAAA;AACvG,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAA;AAC/E,OAAO,EAAE,+BAA+B,EAAE,MAAM,0EAA0E,CAAA;AAE1H;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,gCAAgC;IAChC,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,iDAAiD;IACjD,UAAU,EAAE,UAAU,CAAA;IACtB,iCAAiC;IACjC,iBAAiB,EAAE,iBAAiB,CAAA;IACpC,yCAAyC;IACzC,uBAAuB,CAAC,EAAE,uBAAuB,CAAA;IACjD,yCAAyC;IACzC,2BAA2B,CAAC,EAAE,2BAA2B,CAAA;IACzD,yCAAyC;IACzC,uBAAuB,CAAC,EAAE,uBAAuB,CAAA;CAClD;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,6DAA6D;IAC7D,SAAgB,uBAAuB,EAAE,2BAA2B,CAAA;IACpE,uDAAuD;IACvD,SAAgB,uBAAuB,EAAE,uBAAuB,CAAA;IAChE,qDAAqD;IACrD,SAAgB,0BAA0B,EAAE,8BAA8B,CAAA;IAC1E,0EAA0E;IAC1E,SAAgB,uBAAuB,EAAE,uBAAuB,CAAA;IAChE,0DAA0D;IAC1D,SAAgB,8BAA8B,EAAE,kCAAkC,CAAA;IAClF,kEAAkE;IAClE,SAAgB,kCAAkC,EAAE,kCAAkC,CAAA;IACtF,gFAAgF;IAChF,SAAgB,uBAAuB,EAAE,uBAAuB,CAAA;IAChE,wDAAwD;IACxD,SAAgB,+BAA+B,EAAE,+BAA+B,CAAA;IAEhF;;;;OAIG;gBACgB,MAAM,EAAE,uBAAuB;CAiCnD"}

package/dist/di/security-component.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=security-component.test.d.ts.map

package/dist/di/security-component.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security-component.test.d.ts","sourceRoot":"","sources":["../../src/di/security-component.test.ts"],"names":[],"mappings":""}

package/dist/error/model/security-error.d.ts

@@ -0,0 +1,117 @@
+import { ClientSecurityErrorCodes, PasswordPolicyFailReason } from '@mudrichenkoevgeny/shared-foundation';
+import { ErrorId } from '@mudrichenkoevgeny/web-platform-sdk-core-common';
+/** Error indicating security/password policy settings could not be fetched. */
+export type SecurityErrorPasswordPolicyUnavailable = {
+    readonly id: ErrorId;
+    readonly code: typeof ClientSecurityErrorCodes.PASSWORD_POLICY_UNAVAILABLE;
+    readonly args: null;
+    readonly isRetryable: true;
+};
+/** Error indicating candidate password is shorter than minimum required length. */
+export type SecurityErrorPasswordTooShort = {
+    readonly id: ErrorId;
+    readonly code: typeof PasswordPolicyFailReason.TOO_SHORT;
+    readonly args: Record<string, string> | null;
+    readonly isRetryable: false;
+};
+/** Error indicating candidate password contains no letter character. */
+export type SecurityErrorPasswordNoLetter = {
+    readonly id: ErrorId;
+    readonly code: typeof PasswordPolicyFailReason.NO_LETTER;
+    readonly args: null;
+    readonly isRetryable: false;
+};
+/** Error indicating candidate password contains no uppercase letter. */
+export type SecurityErrorPasswordNoUpperCase = {
+    readonly id: ErrorId;
+    readonly code: typeof PasswordPolicyFailReason.NO_UPPERCASE;
+    readonly args: null;
+    readonly isRetryable: false;
+};
+/** Error indicating candidate password contains no lowercase letter. */
+export type SecurityErrorPasswordNoLowerCase = {
+    readonly id: ErrorId;
+    readonly code: typeof PasswordPolicyFailReason.NO_LOWERCASE;
+    readonly args: null;
+    readonly isRetryable: false;
+};
+/** Error indicating candidate password contains no digit character. */
+export type SecurityErrorPasswordNoDigit = {
+    readonly id: ErrorId;
+    readonly code: typeof PasswordPolicyFailReason.NO_DIGIT;
+    readonly args: null;
+    readonly isRetryable: false;
+};
+/** Error indicating candidate password contains no special character. */
+export type SecurityErrorPasswordNoSpecialChar = {
+    readonly id: ErrorId;
+    readonly code: typeof PasswordPolicyFailReason.NO_SPECIAL_CHAR;
+    readonly args: null;
+    readonly isRetryable: false;
+};
+/** Error indicating candidate password is on the forbidden common passwords list. */
+export type SecurityErrorPasswordTooCommon = {
+    readonly id: ErrorId;
+    readonly code: typeof PasswordPolicyFailReason.TOO_COMMON;
+    readonly args: null;
+    readonly isRetryable: false;
+};
+/**
+ * Discriminated union type representing security domain errors.
+ */
+export type SecurityError = SecurityErrorPasswordPolicyUnavailable | SecurityErrorPasswordTooShort | SecurityErrorPasswordNoLetter | SecurityErrorPasswordNoUpperCase | SecurityErrorPasswordNoLowerCase | SecurityErrorPasswordNoDigit | SecurityErrorPasswordNoSpecialChar | SecurityErrorPasswordTooCommon;
+/**
+ * Factory helper object for constructing {@link SecurityError} plain objects.
+ */
+export declare const SecurityError: {
+    /**
+     * Creates a password policy unavailable error.
+     *
+     * @returns {@link SecurityErrorPasswordPolicyUnavailable}
+     */
+    passwordPolicyUnavailable: () => SecurityErrorPasswordPolicyUnavailable;
+    /**
+     * Creates a password too short validation error.
+     *
+     * @param minLength - Optional minimum length requirement
+     * @returns {@link SecurityErrorPasswordTooShort}
+     */
+    passwordTooShort: (minLength?: number | null) => SecurityErrorPasswordTooShort;
+    /**
+     * Creates a password missing letter validation error.
+     *
+     * @returns {@link SecurityErrorPasswordNoLetter}
+     */
+    passwordNoLetter: () => SecurityErrorPasswordNoLetter;
+    /**
+     * Creates a password missing uppercase letter validation error.
+     *
+     * @returns {@link SecurityErrorPasswordNoUpperCase}
+     */
+    passwordNoUpperCase: () => SecurityErrorPasswordNoUpperCase;
+    /**
+     * Creates a password missing lowercase letter validation error.
+     *
+     * @returns {@link SecurityErrorPasswordNoLowerCase}
+     */
+    passwordNoLowerCase: () => SecurityErrorPasswordNoLowerCase;
+    /**
+     * Creates a password missing digit validation error.
+     *
+     * @returns {@link SecurityErrorPasswordNoDigit}
+     */
+    passwordNoDigit: () => SecurityErrorPasswordNoDigit;
+    /**
+     * Creates a password missing special character validation error.
+     *
+     * @returns {@link SecurityErrorPasswordNoSpecialChar}
+     */
+    passwordNoSpecialChar: () => SecurityErrorPasswordNoSpecialChar;
+    /**
+     * Creates a password too common validation error.
+     *
+     * @returns {@link SecurityErrorPasswordTooCommon}
+     */
+    passwordTooCommon: () => SecurityErrorPasswordTooCommon;
+};
+//# sourceMappingURL=security-error.d.ts.map

package/dist/error/model/security-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security-error.d.ts","sourceRoot":"","sources":["../../../src/error/model/security-error.ts"],"names":[],"mappings":"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"}

package/dist/error/model/security-error.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=security-error.test.d.ts.map

package/dist/error/model/security-error.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security-error.test.d.ts","sourceRoot":"","sources":["../../../src/error/model/security-error.test.ts"],"names":[],"mappings":""}

package/dist/error/parser/security-error-parser.d.ts

@@ -0,0 +1,37 @@
+import { SecurityModuleStrings } from '@mudrichenkoevgeny/shared-foundation';
+import { AppError, AppErrorParser } from '@mudrichenkoevgeny/web-platform-sdk-core-common';
+/**
+ * AppErrorParser implementation for security-domain error codes.
+ */
+export declare class SecurityErrorParser implements AppErrorParser {
+    /**
+     * Getter function returning the localized strings for the security module.
+     *
+     * @returns The localized string dictionary for the security module.
+     */
+    private readonly getStrings;
+    /**
+     * Constructs a new {@link SecurityErrorParser}.
+     *
+     * @param stringsOrGetter - Core security strings dictionary or dynamic getter function returning current strings
+     */
+    constructor(stringsOrGetter?: SecurityModuleStrings | (() => SecurityModuleStrings));
+    /**
+     * Parses security domain errors into localized string messages.
+     *
+     * @param appError - Application error instance
+     * @returns Localized string message or null if code is unhandled by this parser
+     */
+    parse(appError: AppError): string | null;
+    /**
+     * Resolves a localized string using error arguments, falling back to a message without arguments if the required argument is missing.
+     *
+     * @param args - The arguments record from the AppError.
+     * @param key - The key of the argument to extract.
+     * @param withArgsFormatter - Formatting function to generate the localized string when the argument is present.
+     * @param fallback - The fallback localized string to return if the argument is missing.
+     * @returns The resolved localized string.
+     */
+    private resolveLocalizedString;
+}
+//# sourceMappingURL=security-error-parser.d.ts.map

package/dist/error/parser/security-error-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security-error-parser.d.ts","sourceRoot":"","sources":["../../../src/error/parser/security-error-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,qBAAqB,EAEtB,MAAM,sCAAsC,CAAA;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAA;AAG/F;;GAEG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IACxD;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IAExD;;;;OAIG;gBAED,eAAe,GAAE,qBAAqB,GAAG,CAAC,MAAM,qBAAqB,CAAmB;IAK1F;;;;;OAKG;IACI,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI;IA6E/C;;;;;;;;OAQG;IACH,OAAO,CAAC,sBAAsB;CAY/B"}

package/dist/error/parser/security-error-parser.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=security-error-parser.test.d.ts.map

package/dist/error/parser/security-error-parser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security-error-parser.test.d.ts","sourceRoot":"","sources":["../../../src/error/parser/security-error-parser.test.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export * from './error/model/security-error.js';
+export * from './error/parser/security-error-parser.js';
+export * from './storage/security-settings/open-security-settings-storage.js';
+export * from './storage/security-settings/encrypted-open-security-settings-storage.js';
+export * from './network/api/security-settings/open-security-settings-api.js';
+export * from './network/api/security-settings/fetch-open-security-settings-api.js';
+export * from './network/contract/security-web-socket-event-types.js';
+export * from './network/websocket/message-handler/security-web-socket-message-handler.js';
+export * from './repository/open-security-settings-repository.js';
+export * from './repository/open-security-settings-repository-impl.js';
+export * from './usecase/refresh-open-security-settings-use-case.js';
+export * from './usecase/observe-open-security-settings-use-case.js';
+export * from './usecase/validate-password-use-case.js';
+export * from './di/security-component.js';
+export * from './mock/network/open-security-settings-api-mock.js';
+export * from './mock/repository/open-security-settings-repository-mock.js';
+export * from './mock/storage/open-security-settings-storage-mock.js';
+export * from './mock/usecase/validate-password-use-case-mock.js';
+export * from './mock/di/security-component-mock.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAA;AAC/C,cAAc,yCAAyC,CAAA;AACvD,cAAc,+DAA+D,CAAA;AAC7E,cAAc,yEAAyE,CAAA;AACvF,cAAc,+DAA+D,CAAA;AAC7E,cAAc,qEAAqE,CAAA;AACnF,cAAc,uDAAuD,CAAA;AACrE,cAAc,4EAA4E,CAAA;AAC1F,cAAc,mDAAmD,CAAA;AACjE,cAAc,wDAAwD,CAAA;AACtE,cAAc,sDAAsD,CAAA;AACpE,cAAc,sDAAsD,CAAA;AACpE,cAAc,yCAAyC,CAAA;AACvD,cAAc,4BAA4B,CAAA;AAC1C,cAAc,mDAAmD,CAAA;AACjE,cAAc,6DAA6D,CAAA;AAC3E,cAAc,uDAAuD,CAAA;AACrE,cAAc,mDAAmD,CAAA;AACjE,cAAc,sCAAsC,CAAA"}