@gravito/cosmos 2.0.0 → 3.0.1

package/.turbo/turbo-build.log

@@ -0,0 +1,20 @@
+
+$ bun run build.ts
+Building @gravito/cosmos...
+⠙⠹⠸⠼⠴⠦⠧⠇⠏⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏⠋⠙⠹CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Target: esnext
+ESM Build start
+CJS Build start
+ESM You have emitDecoratorMetadata enabled but @swc/core was not installed, skipping swc plugin
+CJS You have emitDecoratorMetadata enabled but @swc/core was not installed, skipping swc plugin
+ESM dist/index.js 6.93 KB
+ESM ⚡️ Build success in 72ms
+CJS dist/index.cjs 8.20 KB
+CJS ⚡️ Build success in 72ms
+DTS Build start
+DTS ⚡️ Build success in 7986ms
+DTS dist/index.d.ts  7.87 KB
+DTS dist/index.d.cts 7.87 KB
+⠙✅ Build complete!

package/.turbo/turbo-test$colon$ci.log

@@ -0,0 +1,35 @@
+$ bun test --coverage --coverage-threshold=80
+bun test v1.3.4 (5eb2145b)
+
+tests/manager.test.ts:
+(pass) Orbit I18n Manager > it selects default locale initially [0.11ms]
+(pass) Orbit I18n Manager > it can change locale [0.10ms]
+(pass) Orbit I18n Manager > it translates simple keys [0.10ms]
+(pass) Orbit I18n Manager > it handles fallback to default locale [0.09ms]
+(pass) Orbit I18n Manager > it returns key if not found [0.02ms]
+(pass) Orbit I18n Manager > it supports replacements [0.14ms]
+
+tests/service.test.ts:
+(pass) I18nManager and I18nInstance > adds resources and translates with replacements [0.06ms]
+(pass) I18nManager and I18nInstance > clones instances with explicit locale [0.06ms]
+(pass) I18nManager and I18nInstance > returns key when value is not a string
+(pass) localeMiddleware > prefers route param locale and injects i18n [0.31ms]
+(pass) localeMiddleware > uses default locale when none provided [0.08ms]
+(pass) OrbitCosmos > installs locale middleware and logs initialization [0.09ms]
+
+tests/loader.test.ts:
+(pass) loadTranslations > loads json translation files from a directory [3.04ms]
+(pass) loadTranslations > skips invalid json files and returns empty for missing dir [3.82ms]
+--------------------|---------|---------|-------------------
+File                | % Funcs | % Lines | Uncovered Line #s
+--------------------|---------|---------|-------------------
+All files           |   93.94 |   98.60 |
+ src/I18nService.ts |   81.82 |   95.79 | 96,137,146
+ src/index.ts       |  100.00 |  100.00 | 
+ src/loader.ts      |  100.00 |  100.00 | 
+--------------------|---------|---------|-------------------
+
+ 14 pass
+ 0 fail
+ 22 expect() calls
+Ran 14 tests across 3 files. [32.00ms]

package/.turbo/turbo-test$colon$coverage.log

@@ -0,0 +1,35 @@
+$ bun test --coverage --coverage-threshold=80
+bun test v1.3.4 (5eb2145b)
+
+tests/manager.test.ts:
+(pass) Orbit I18n Manager > it selects default locale initially [1.76ms]
+(pass) Orbit I18n Manager > it can change locale [0.57ms]
+(pass) Orbit I18n Manager > it translates simple keys [0.55ms]
+(pass) Orbit I18n Manager > it handles fallback to default locale [0.06ms]
+(pass) Orbit I18n Manager > it returns key if not found [0.03ms]
+(pass) Orbit I18n Manager > it supports replacements [1.15ms]
+
+tests/service.test.ts:
+(pass) I18nManager and I18nInstance > adds resources and translates with replacements [0.29ms]
+(pass) I18nManager and I18nInstance > clones instances with explicit locale [0.12ms]
+(pass) I18nManager and I18nInstance > returns key when value is not a string
+(pass) localeMiddleware > prefers route param locale and injects i18n [0.76ms]
+(pass) localeMiddleware > uses default locale when none provided [11.82ms]
+(pass) OrbitCosmos > installs locale middleware and logs initialization [2.78ms]
+
+tests/loader.test.ts:
+(pass) loadTranslations > loads json translation files from a directory [34.71ms]
+(pass) loadTranslations > skips invalid json files and returns empty for missing dir [15.72ms]
+--------------------|---------|---------|-------------------
+File                | % Funcs | % Lines | Uncovered Line #s
+--------------------|---------|---------|-------------------
+All files           |   92.00 |   96.30 |
+ src/I18nService.ts |   76.00 |   88.89 | 160,167-174,215,224
+ src/index.ts       |  100.00 |  100.00 | 
+ src/loader.ts      |  100.00 |  100.00 | 
+--------------------|---------|---------|-------------------
+
+ 14 pass
+ 0 fail
+ 23 expect() calls
+Ran 14 tests across 3 files. [175.00ms]

package/.turbo/turbo-test.log

@@ -0,0 +1,27 @@
+$ bun test
+bun test v1.3.4 (5eb2145b)
+
+tests/manager.test.ts:
+(pass) Orbit I18n Manager > it selects default locale initially [0.40ms]
+(pass) Orbit I18n Manager > it can change locale [0.19ms]
+(pass) Orbit I18n Manager > it translates simple keys [0.49ms]
+(pass) Orbit I18n Manager > it handles fallback to default locale
+(pass) Orbit I18n Manager > it returns key if not found [0.09ms]
+(pass) Orbit I18n Manager > it supports replacements [32.97ms]
+
+tests/service.test.ts:
+(pass) I18nManager and I18nInstance > adds resources and translates with replacements [0.67ms]
+(pass) I18nManager and I18nInstance > clones instances with explicit locale [0.85ms]
+(pass) I18nManager and I18nInstance > returns key when value is not a string
+(pass) localeMiddleware > prefers route param locale and injects i18n [1.68ms]
+(pass) localeMiddleware > uses default locale when none provided [0.22ms]
+(pass) OrbitCosmos > installs locale middleware and logs initialization [89.64ms]
+
+tests/loader.test.ts:
+(pass) loadTranslations > loads json translation files from a directory [127.44ms]
+(pass) loadTranslations > skips invalid json files and returns empty for missing dir [126.24ms]
+
+ 14 pass
+ 0 fail
+ 23 expect() calls
+Ran 14 tests across 3 files. [1257.00ms]

package/.turbo/turbo-typecheck.log

@@ -0,0 +1,2 @@
+
+$ bun tsc -p tsconfig.json --noEmit --skipLibCheck

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @gravito/cosmos
 
+## 3.0.1
+
+### Patch Changes
+
+- Updated dependencies
+  - @gravito/core@1.2.1
+
+## 3.0.0
+
+### Patch Changes
+
+- Updated dependencies
+  - @gravito/core@1.2.0
+
 ## 2.0.0
 
 ### Patch Changes

package/build.ts

@@ -0,0 +1,35 @@
+import { spawn } from 'bun'
+
+console.log('Building @gravito/cosmos...')
+
+// Clean dist
+await Bun.$`rm -rf dist`
+
+// Use tsup for multi-format build
+const tsup = spawn(
+  [
+    'npx',
+    'tsup',
+    'src/index.ts',
+    '--format',
+    'esm,cjs',
+    '--dts',
+    '--external',
+    '@gravito/core,@gravito/photon',
+    '--outDir',
+    'dist',
+  ],
+  {
+    stdout: 'inherit',
+    stderr: 'inherit',
+  }
+)
+
+const tsupCode = await tsup.exited
+if (tsupCode !== 0) {
+  console.error('❌ tsup build failed')
+  process.exit(1)
+}
+
+console.log('✅ Build complete!')
+process.exit(0)

package/dist/index.cjs

@@ -0,0 +1,309 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  I18nInstance: () => I18nInstance,
+  I18nManager: () => I18nManager,
+  I18nOrbit: () => I18nOrbit,
+  OrbitCosmos: () => OrbitCosmos,
+  loadTranslations: () => loadTranslations,
+  localeMiddleware: () => localeMiddleware
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/I18nService.ts
+var I18nInstance = class _I18nInstance {
+  /**
+   * Create a new I18nInstance.
+   *
+   * @param manager - The I18nManager instance.
+   * @param initialLocale - The initial locale for this instance.
+   */
+  constructor(manager, initialLocale) {
+    this.manager = manager;
+    this._locale = initialLocale;
+  }
+  _locale;
+  get locale() {
+    return this._locale;
+  }
+  set locale(value) {
+    this.setLocale(value);
+  }
+  /**
+   * Set the current locale.
+   *
+   * @param locale - The locale to set.
+   */
+  setLocale(locale) {
+    if (this.manager.getConfig().supportedLocales.includes(locale)) {
+      this._locale = locale;
+    }
+  }
+  /**
+   * Get the current locale.
+   *
+   * @returns The current locale string.
+   */
+  getLocale() {
+    return this._locale;
+  }
+  /**
+   * Translate a key.
+   *
+   * @param key - The translation key (e.g., 'messages.welcome').
+   * @param replacements - Optional replacements for parameters in the translation string.
+   * @returns The translated string, or the key if not found.
+   */
+  t(key, replacements) {
+    return this.manager.translate(this._locale, key, replacements);
+  }
+  /**
+   * Check if a translation key exists.
+   *
+   * @param key - The translation key to check.
+   * @returns True if the key exists, false otherwise.
+   */
+  has(key) {
+    return this.t(key) !== key;
+  }
+  /**
+   * Clone the current instance with a potentially new locale.
+   *
+   * @param locale - Optional new locale for the cloned instance.
+   * @returns A new I18nInstance.
+   */
+  clone(locale) {
+    return new _I18nInstance(this.manager, locale || this._locale);
+  }
+  /**
+   * Get the I18n configuration.
+   */
+  getConfig() {
+    return this.manager.getConfig();
+  }
+  /**
+   * Get the translations.
+   */
+  get translations() {
+    return this.manager.translations;
+  }
+};
+var I18nManager = class {
+  /**
+   * Create a new I18nManager.
+   *
+   * @param config - The I18n configuration.
+   */
+  constructor(config) {
+    this.config = config;
+    if (config.translations) {
+      this.translations = config.translations;
+    }
+    this.globalInstance = new I18nInstance(this, config.defaultLocale);
+  }
+  translations = {};
+  // Default instance for global usage (e.g. CLI or background jobs)
+  globalInstance;
+  // --- I18nService Implementation (Delegates to global instance) ---
+  get locale() {
+    return this.globalInstance.locale;
+  }
+  set locale(value) {
+    this.globalInstance.locale = value;
+  }
+  /**
+   * Set the global locale.
+   *
+   * @param locale - The locale to set.
+   */
+  setLocale(locale) {
+    this.globalInstance.setLocale(locale);
+  }
+  /**
+   * Get the global locale.
+   *
+   * @returns The global locale string.
+   */
+  getLocale() {
+    return this.globalInstance.getLocale();
+  }
+  /**
+   * Translate a key using the global locale.
+   *
+   * @param key - The translation key.
+   * @param replacements - Optional replacements.
+   * @returns The translated string.
+   */
+  t(key, replacements) {
+    return this.globalInstance.t(key, replacements);
+  }
+  /**
+   * Check if a translation key exists in the global locale.
+   *
+   * @param key - The translation key.
+   * @returns True if found.
+   */
+  has(key) {
+    return this.globalInstance.has(key);
+  }
+  /**
+   * Clone the global instance.
+   *
+   * @param locale - Optional locale for the clone.
+   * @returns A new I18nInstance.
+   */
+  clone(locale) {
+    return new I18nInstance(this, locale || this.config.defaultLocale);
+  }
+  // --- Manager Internal API ---
+  /**
+   * Get the I18n configuration.
+   *
+   * @returns The configuration object.
+   */
+  getConfig() {
+    return this.config;
+  }
+  /**
+   * Add a resource bundle for a specific locale.
+   *
+   * @param locale - The locale string.
+   * @param translations - The translations object.
+   */
+  addResource(locale, translations) {
+    this.translations[locale] = {
+      ...this.translations[locale] || {},
+      ...translations
+    };
+  }
+  /**
+   * Internal translation logic used by instances
+   */
+  translate(locale, key, replacements) {
+    const keys = key.split(".");
+    let value = this.translations[locale];
+    for (const k of keys) {
+      if (value && typeof value === "object" && k in value) {
+        value = value[k];
+      } else {
+        value = void 0;
+        break;
+      }
+    }
+    if (value === void 0 && locale !== this.config.defaultLocale) {
+      let fallbackValue = this.translations[this.config.defaultLocale];
+      for (const k of keys) {
+        if (fallbackValue && typeof fallbackValue === "object" && k in fallbackValue) {
+          fallbackValue = fallbackValue[k];
+        } else {
+          fallbackValue = void 0;
+          break;
+        }
+      }
+      value = fallbackValue;
+    }
+    if (value === void 0 || typeof value !== "string") {
+      return key;
+    }
+    if (replacements && Object.keys(replacements).length > 0) {
+      value = value.replace(REPLACEMENT_REGEX, (match, key2) => {
+        return replacements[key2] !== void 0 ? String(replacements[key2]) : match;
+      });
+    }
+    return value;
+  }
+};
+var REPLACEMENT_REGEX = /:([a-zA-Z0-9_]+)/g;
+var localeMiddleware = (i18nManager) => {
+  return async (c, next) => {
+    let locale = c.req.param("locale") || c.req.query("lang");
+    if (!locale) {
+      const acceptLang = c.req.header("Accept-Language");
+      if (acceptLang) {
+        locale = acceptLang.split(",")[0]?.trim();
+      }
+    }
+    const i18n = i18nManager.clone(locale);
+    c.set("i18n", i18n);
+    return await next();
+  };
+};
+
+// src/loader.ts
+var import_promises = require("fs/promises");
+var import_node_path = require("path");
+async function loadTranslations(directory) {
+  const translations = {};
+  try {
+    const files = await (0, import_promises.readdir)(directory);
+    for (const file of files) {
+      if (!file.endsWith(".json")) {
+        continue;
+      }
+      const locale = (0, import_node_path.parse)(file).name;
+      const content = await (0, import_promises.readFile)((0, import_node_path.join)(directory, file), "utf-8");
+      try {
+        translations[locale] = JSON.parse(content);
+      } catch (e) {
+        console.error(`[Orbit-I18n] Failed to parse translation file: ${file}`, e);
+      }
+    }
+  } catch (_e) {
+    console.warn(
+      `[Orbit-I18n] Could not load translations from ${directory}. Directory might not exist.`
+    );
+  }
+  return translations;
+}
+
+// src/index.ts
+var OrbitCosmos = class {
+  /**
+   * Create a new OrbitCosmos instance.
+   * @param config - The i18n configuration options.
+   */
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Install the i18n service into PlanetCore.
+   * Registers the I18nManager and sets up the locale middleware.
+   *
+   * @param core - The PlanetCore instance.
+   */
+  install(core) {
+    const i18nManager = new I18nManager(this.config);
+    core.container.instance("i18n", i18nManager);
+    core.adapter.use("*", localeMiddleware(i18nManager));
+    core.logger.info(`[OrbitCosmos] I18n initialized with locale: ${this.config.defaultLocale}`);
+  }
+};
+var I18nOrbit = OrbitCosmos;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  I18nInstance,
+  I18nManager,
+  I18nOrbit,
+  OrbitCosmos,
+  loadTranslations,
+  localeMiddleware
+});