chore(i18n): implement dynamic loading of translation bundles and add TranslationBundleConstants

Author: brionmario

packages/i18n/.editorconfig

@@ -1 +1 @@
-../../.editorconfig
+../../.editorconfig

packages/i18n/.eslintignore

@@ -1,4 +1,4 @@
 /dist
 /build
 /node_modules
-/coverage
+/coverage

packages/i18n/package.json

@@ -57,4 +57,4 @@
   "publishConfig": {
     "access": "public"
   }
-}
+}

packages/i18n/src/constants/TranslationBundleConstants.ts

@@ -0,0 +1,48 @@
+/**
+ * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).
+ *
+ * WSO2 LLC. licenses this file to you under the Apache License,
+ * Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+import {en_US} from '../translations';
+
+/**
+ * Constants related to internationalization (i18n) translation bundles.
+ *
+ * @example
+ * ```typescript
+ * // Using default locale
+ * const locale = TranslationBundleConstants.FALLBACK_LOCALE;
+ *
+ * // Using supported locales
+ * const locales = TranslationBundleConstants.DEFAULT_LOCALES;
+ * ```
+ */
+const TranslationBundleConstants = {
+  /**
+   * Default locale code used as fallback when no specific locale is provided.
+   */
+  FALLBACK_LOCALE: en_US.metadata.localeCode,
+
+  /**
+   * List of default locales bundles with the SDKs.
+   *
+   * Current default locales:
+   * - `en-US` - English (United States)
+   */
+  DEFAULT_LOCALES: [en_US.metadata.localeCode],
+} as const;
+
+export default TranslationBundleConstants;

packages/i18n/src/translations/index.ts

@@ -16,8 +16,4 @@
  * under the License.
  */
 
-// IMPORTANT: Only include default bundled languages here.
-// Current List:
-//   1. en-US
-
 export {default as en_US} from './en-US';

packages/i18n/src/utils/getDefaultI18nBundles.ts

@@ -16,16 +16,34 @@
  * under the License.
  */
 
-import * as i18n from '../translations';
+import TranslationBundleConstants from '../constants/TranslationBundleConstants';
+import {I18nBundle} from '../models/i18n';
+import * as translations from '../translations';
 
 /**
  * Get the default i18n bundles.
+ * Dynamically builds the bundles collection by iterating through supported locales
+ * and importing their corresponding translation modules.
  *
- * @param locale - The locale to get the bundle for (defaults to 'en-US')
- * @returns The i18n bundle for the specified locale
+ * @returns The collection of all default i18n bundles
  */
-const getDefaultI18nBundles = () => {
-  return i18n;
+const getDefaultI18nBundles = (): Record<string, I18nBundle> => {
+  const bundles: Record<string, I18nBundle> = {};
+
+  // Iterate through supported locales and build bundles dynamically
+  TranslationBundleConstants.DEFAULT_LOCALES.forEach(localeCode => {
+    // Convert locale code to translation module key (e.g., 'en-US' -> 'en_US')
+    const moduleKey = localeCode.replace('-', '_') as keyof typeof translations;
+
+    // Get the translation bundle from the translations module
+    const bundle = translations[moduleKey] as I18nBundle;
+
+    if (bundle && bundle.metadata?.localeCode) {
+      bundles[bundle.metadata.localeCode] = bundle;
+    }
+  });
+
+  return bundles;
 };
 
 export default getDefaultI18nBundles;

packages/i18n/tsconfig.eslint.json

@@ -1,11 +1,4 @@
 {
   "extends": "./tsconfig.json",
-  "include": [
-    "**/.*.js",
-    "**/.*.cjs",
-    "**/.*.ts",
-    "**/*.js",
-    "**/*.cjs",
-    "**/*.ts",
-  ]
+  "include": ["**/.*.js", "**/.*.cjs", "**/.*.ts", "**/*.js", "**/*.cjs", "**/*.ts"]
 }