@digitaldefiance/suite-core-lib 3.10.30 → 3.12.1

package/README.md

@@ -60,27 +60,27 @@ import {
   safeGetSuiteCoreTranslation,
   SuiteCoreStringKey 
 } from '@digitaldefiance/suite-core-lib';
+import { LanguageCodes } from '@digitaldefiance/i18n-lib';
 
 // Direct translation using branded string keys (v3.10.0+)
 // Component ID is automatically resolved from the branded enum
-const message = getSuiteCoreTranslation(SuiteCoreStringKey.Common_Yes);
-// Output: "Yes" (or localized equivalent)
+const message = getSuiteCoreTranslation(SuiteCoreStringKey.Auth_UserNotFound);
+// Output: "User account not found" (or localized equivalent)
 
-// With variables
-const greeting = getSuiteCoreTranslation(
-  SuiteCoreStringKey.Welcome_Template, 
-  { name: 'Alice' }
+// With variables (if the string supports them)
+const validation = getSuiteCoreTranslation(
+  SuiteCoreStringKey.Validation_InvalidUsername
 );
 
 // With specific language
 const french = getSuiteCoreTranslation(
-  SuiteCoreStringKey.Common_Yes,
+  SuiteCoreStringKey.Auth_AccountLocked,
   {},
-  CoreLanguage.French
+  LanguageCodes.FR  // or use string directly: 'fr'
 );
 
 // Safe version returns placeholder on failure instead of throwing
-const safe = safeGetSuiteCoreTranslation(SuiteCoreStringKey.Common_Yes);
+const safe = safeGetSuiteCoreTranslation(SuiteCoreStringKey.Auth_TokenExpired);
 ```
 
 ## 🏗️ Architecture Overview
@@ -149,13 +149,13 @@ import {
 } from '@digitaldefiance/suite-core-lib';
 
 // Throw errors with automatic localization support
-throw new UserNotFoundError(CoreLanguage.French);
+throw new UserNotFoundError(LanguageCodes.French);
 // Output: "Compte utilisateur introuvable"
 
-throw new UsernameInUseError(CoreLanguage.Spanish); 
+throw new UsernameInUseError(LanguageCodes.Spanish); 
 // Output: "El nombre de usuario ya está en uso"
 
-throw new AccountLockedError(CoreLanguage.German);
+throw new AccountLockedError(LanguageCodes.German);
 // Output: "Konto ist von einem Administrator gesperrt"
 ```
 
@@ -384,7 +384,13 @@ import {
   isValidEmail, 
   isValidPassword,
   createValidators,
-  createConstants 
+  createConstants,
+  formatBackupCode,
+  normalizeBackupCode,
+  isValidBackupCodeFormat,
+  hydrateUserSettings,
+  dehydrateUserSettings,
+  BCP47_TO_FLAG_CDN
 } from '@digitaldefiance/suite-core-lib';
 
 // Use default validators with built-in constants
@@ -403,6 +409,25 @@ const validators = createValidators(myConstants);
 if (!validators.isValidUsername('user_name')) {
   throw new Error('Invalid username');
 }
+
+// Format backup codes
+const formatted = formatBackupCode('1234567890ABCDEF'); // "1234-5678-90AB-CDEF"
+const normalized = normalizeBackupCode('1234-5678-90AB-CDEF'); // "1234567890ABCDEF"
+const isValid = isValidBackupCodeFormat('1234-5678-90AB-CDEF'); // true
+
+// Hydrate/dehydrate user settings
+const settings = hydrateUserSettings({
+  email: 'user@example.com',
+  timezone: 'America/New_York',
+  currency: 'USD',
+  siteLanguage: 'en-US',
+  darkMode: false,
+  directChallenge: true
+});
+const dto = dehydrateUserSettings(settings);
+
+// Map language codes to flag codes for UI
+const flagCode = BCP47_TO_FLAG_CDN['en-US']; // 'us'
 ```
 
 ### Improved Architecture
@@ -561,11 +586,11 @@ describe('Validators', () => {
 #### Testing Error Handling
 
 ```typescript
-import { UserNotFoundError, UsernameInUseError, CoreLanguage } from '@digitaldefiance/suite-core-lib';
+import { UserNotFoundError, UsernameInUseError } from '@digitaldefiance/suite-core-lib';
 
 describe('Error Handling', () => {
   it('should throw localized errors', () => {
-    const error = new UserNotFoundError(CoreLanguage.French);
+    const error = new UserNotFoundError(LanguageCodes.French);
     expect(error.message).toContain('utilisateur');
   });
 });
@@ -611,7 +636,7 @@ describe('User Management', () => {
 - Added `registerStringKeyEnum(SuiteCoreStringKey)` during engine initialization
 - Updated `getSuiteCoreTranslation()` to use `translateStringKey()` for automatic component ID resolution
 - Updated `safeGetSuiteCoreTranslation()` to use `safeTranslateStringKey()`
-- Changed `SuiteCoreComponentStrings` to use `BrandedMasterStringsCollection<typeof SuiteCoreStringKey, CoreLanguageCode>` for type-safe branded enum support
+- Changed `SuiteCoreComponentStrings` to use `BrandedMasterStringsCollection<typeof SuiteCoreStringKey>` for type-safe branded enum support
 - Upgraded `@digitaldefiance/ecies-lib` from 4.15.6 to 4.16.20
 - Upgraded `@digitaldefiance/i18n-lib` from 4.0.5 to 4.2.20
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitaldefiance/suite-core-lib",
-  "version": "3.10.30",
+  "version": "3.12.1",
   "homepage": "https://github.com/Digital-Defiance/suite-core-lib",
   "repository": {
     "type": "git",
@@ -28,8 +28,8 @@
     "publish:public": "npm publish --access public"
   },
   "dependencies": {
-    "@digitaldefiance/ecies-lib": "4.16.30",
-    "@digitaldefiance/i18n-lib": "4.3.0"
+    "@digitaldefiance/ecies-lib": "4.17.2",
+    "@digitaldefiance/i18n-lib": "4.3.2"
   },
   "files": [
     "src",

package/src/interfaces/api-message-response.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Base API message response interface.
+ * Defines minimal structure for all API responses.
+ * @module interfaces/api-message-response
+ */
+/**
+ * Base API response with message.
+ */
+export interface IApiMessageResponse {
+    message: string;
+}
+//# sourceMappingURL=api-message-response.d.ts.map

package/src/interfaces/api-message-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-message-response.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-suite-core-lib/src/interfaces/api-message-response.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/src/interfaces/api-message-response.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * @fileoverview Base API message response interface.
+ * Defines minimal structure for all API responses.
+ * @module interfaces/api-message-response
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=api-message-response.js.map

package/src/interfaces/api-message-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-message-response.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-suite-core-lib/src/interfaces/api-message-response.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/src/interfaces/index.d.ts

@@ -1,6 +1,7 @@
 /**
  * Interface exports for the suite-core library.
  */
+export type * from './api-message-response';
 export * from './backup-code';
 export * from './backup-code-consts';
 export * from './bases';

package/src/interfaces/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-suite-core-lib/src/interfaces/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,OAAO,CAAC;AACtB,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-suite-core-lib/src/interfaces/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,mBAAmB,wBAAwB,CAAC;AAC5C,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,OAAO,CAAC;AACtB,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}

package/src/interfaces/index.js

@@ -1,9 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
-/**
- * Interface exports for the suite-core library.
- */
 tslib_1.__exportStar(require("./backup-code"), exports);
 tslib_1.__exportStar(require("./backup-code-consts"), exports);
 tslib_1.__exportStar(require("./bases"), exports);

package/src/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-suite-core-lib/src/interfaces/index.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,wDAA8B;AAC9B,+DAAqC;AACrC,kDAAwB;AACxB,qEAA2C;AAC3C,sDAA4B;AAC5B,wDAA8B;AAC9B,yDAA+B;AAC/B,gDAAsB;AACtB,4DAAkC;AAClC,6DAAmC;AACnC,yDAA+B;AAC/B,wDAA8B;AAC9B,mDAAyB;AACzB,4DAAkC;AAClC,6DAAmC;AACnC,iEAAuC;AACvC,2DAAiC;AACjC,wDAA8B;AAC9B,wDAA8B;AAC9B,4DAAkC;AAClC,uDAA6B;AAC7B,0DAAgC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-suite-core-lib/src/interfaces/index.ts"],"names":[],"mappings":";;;AAIA,wDAA8B;AAC9B,+DAAqC;AACrC,kDAAwB;AACxB,qEAA2C;AAC3C,sDAA4B;AAC5B,wDAA8B;AAC9B,yDAA+B;AAC/B,gDAAsB;AACtB,4DAAkC;AAClC,6DAAmC;AACnC,yDAA+B;AAC/B,wDAA8B;AAC9B,mDAAyB;AACzB,4DAAkC;AAClC,6DAAmC;AACnC,iEAAuC;AACvC,2DAAiC;AACjC,wDAA8B;AAC9B,wDAA8B;AAC9B,4DAAkC;AAClC,uDAA6B;AAC7B,0DAAgC"}