@objectstack/service-i18n 3.2.9 → 3.3.1

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @objectstack/service-i18n@3.2.9 build /home/runner/work/spec/spec/packages/services/service-i18n
+> @objectstack/service-i18n@3.3.1 build /home/runner/work/spec/spec/packages/services/service-i18n
 > tsup --config ../../../tsup.config.ts
 
 CLI Building entry: src/index.ts
@@ -10,13 +10,13 @@
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-ESM dist/index.js     6.41 KB
-ESM dist/index.js.map 16.79 KB
-ESM ⚡️ Build success in 77ms
-CJS dist/index.cjs     8.08 KB
-CJS dist/index.cjs.map 17.20 KB
-CJS ⚡️ Build success in 83ms
+ESM dist/index.js     6.84 KB
+ESM dist/index.js.map 18.02 KB
+ESM ⚡️ Build success in 89ms
+CJS dist/index.cjs     8.50 KB
+CJS dist/index.cjs.map 18.42 KB
+CJS ⚡️ Build success in 89ms
 DTS Build start
-DTS ⚡️ Build success in 13417ms
+DTS ⚡️ Build success in 14502ms
 DTS dist/index.d.ts  4.41 KB
 DTS dist/index.d.cts 4.41 KB

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @objectstack/service-i18n
 
+## 3.3.1
+
+### Patch Changes
+
+- 772dc3f: fix i18n
+  - @objectstack/spec@3.3.1
+  - @objectstack/core@3.3.1
+
+## 3.3.0
+
+### Patch Changes
+
+- @objectstack/spec@3.3.0
+- @objectstack/core@3.3.0
+
 ## 3.2.9
 
 ### Patch Changes

package/dist/index.cjs

@@ -47,6 +47,22 @@ function resolveKey(data, key) {
   }
   return typeof current === "string" ? current : void 0;
 }
+function deepMerge(target, source) {
+  const result = { ...target };
+  for (const key of Object.keys(source)) {
+    const tVal = target[key];
+    const sVal = source[key];
+    if (tVal && sVal && typeof tVal === "object" && !Array.isArray(tVal) && typeof sVal === "object" && !Array.isArray(sVal)) {
+      result[key] = deepMerge(
+        tVal,
+        sVal
+      );
+    } else {
+      result[key] = sVal;
+    }
+  }
+  return result;
+}
 function interpolate(template, params) {
   return template.replace(/\{\{(\w+)\}\}/g, (_match, key) => {
     return params[key] != null ? String(params[key]) : `{{${key}}}`;
@@ -78,7 +94,7 @@ var FileI18nAdapter = class {
   loadTranslations(locale, translations) {
     const existing = this.translations.get(locale);
     if (existing) {
-      this.translations.set(locale, { ...existing, ...translations });
+      this.translations.set(locale, deepMerge(existing, translations));
     } else {
       this.translations.set(locale, { ...translations });
     }

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/file-i18n-adapter.ts","../src/i18n-service-plugin.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nexport { I18nServicePlugin } from './i18n-service-plugin.js';\nexport type { I18nServicePluginOptions } from './i18n-service-plugin.js';\nexport { FileI18nAdapter } from './file-i18n-adapter.js';\nexport type { FileI18nAdapterOptions } from './file-i18n-adapter.js';\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { II18nService } from '@objectstack/spec/contracts';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\n\n/**\n * Configuration options for FileI18nAdapter.\n */\nexport interface FileI18nAdapterOptions {\n  /** Default locale (e.g. 'en') */\n  defaultLocale?: string;\n  /** Directory containing locale files (JSON). Each file should be named `{locale}.json`. */\n  localesDir?: string;\n  /** Fallback locale when a key is not found in the requested locale */\n  fallbackLocale?: string;\n}\n\n/**\n * Resolve a nested key in a translations object using dot notation.\n *\n * @param data - Translation data object\n * @param key - Dot-separated key (e.g. 'objects.account.label')\n * @returns The resolved string value, or undefined if not found\n */\nfunction resolveKey(data: Record<string, unknown>, key: string): string | undefined {\n  const parts = key.split('.');\n  let current: unknown = data;\n  for (const part of parts) {\n    if (current == null || typeof current !== 'object') return undefined;\n    current = (current as Record<string, unknown>)[part];\n  }\n  return typeof current === 'string' ? current : undefined;\n}\n\n/**\n * Interpolate parameters into a translated string.\n * Replaces `{{paramName}}` with the corresponding value from params.\n *\n * @param template - Template string with `{{key}}` placeholders\n * @param params - Parameter map\n * @returns Interpolated string\n */\nfunction interpolate(template: string, params: Record<string, unknown>): string {\n  return template.replace(/\\{\\{(\\w+)\\}\\}/g, (_match, key: string) => {\n    return params[key] != null ? String(params[key]) : `{{${key}}}`;\n  });\n}\n\n/**\n * File-based I18n adapter implementing II18nService.\n *\n * Loads JSON translation files from a directory on disk.\n * Each file should be named `{locale}.json` and contain a flat or nested\n * key-value map of translations.\n *\n * Supports:\n * - Dot-notation key resolution (e.g. 'objects.account.label')\n * - Parameter interpolation via `{{paramName}}` syntax\n * - Fallback locale for missing translations\n * - Runtime translation loading via loadTranslations()\n *\n * Suitable for server-side rendering, CLI tools, and development environments.\n *\n * @example\n * ```ts\n * const i18n = new FileI18nAdapter({\n *   defaultLocale: 'en',\n *   localesDir: './i18n',\n *   fallbackLocale: 'en',\n * });\n *\n * i18n.t('objects.account.label', 'zh-CN'); // '客户'\n * i18n.t('greeting', 'en', { name: 'World' }); // 'Hello, World!'\n * ```\n */\nexport class FileI18nAdapter implements II18nService {\n  private readonly translations = new Map<string, Record<string, unknown>>();\n  private defaultLocale: string;\n  private readonly fallbackLocale: string | undefined;\n\n  constructor(options: FileI18nAdapterOptions = {}) {\n    this.defaultLocale = options.defaultLocale ?? 'en';\n    this.fallbackLocale = options.fallbackLocale;\n\n    if (options.localesDir) {\n      this.loadFromDirectory(options.localesDir);\n    }\n  }\n\n  t(key: string, locale: string, params?: Record<string, unknown>): string {\n    // Try requested locale\n    let value = this.resolveFromLocale(key, locale);\n\n    // Try fallback locale\n    if (value === undefined && this.fallbackLocale && this.fallbackLocale !== locale) {\n      value = this.resolveFromLocale(key, this.fallbackLocale);\n    }\n\n    // Return key if not found\n    if (value === undefined) return key;\n\n    // Interpolate parameters\n    if (params && Object.keys(params).length > 0) {\n      return interpolate(value, params);\n    }\n\n    return value;\n  }\n\n  getTranslations(locale: string): Record<string, unknown> {\n    return this.translations.get(locale) ?? {};\n  }\n\n  loadTranslations(locale: string, translations: Record<string, unknown>): void {\n    const existing = this.translations.get(locale);\n    if (existing) {\n      // Merge into existing translations\n      this.translations.set(locale, { ...existing, ...translations });\n    } else {\n      this.translations.set(locale, { ...translations });\n    }\n  }\n\n  getLocales(): string[] {\n    return Array.from(this.translations.keys());\n  }\n\n  getDefaultLocale(): string {\n    return this.defaultLocale;\n  }\n\n  setDefaultLocale(locale: string): void {\n    this.defaultLocale = locale;\n  }\n\n  /**\n   * Load all JSON translation files from a directory.\n   * Each file should be named `{locale}.json`.\n   */\n  private loadFromDirectory(dir: string): void {\n    if (!fs.existsSync(dir)) return;\n\n    const files = fs.readdirSync(dir);\n    for (const file of files) {\n      if (!file.endsWith('.json')) continue;\n      const locale = file.replace(/\\.json$/, '');\n      const filePath = path.join(dir, file);\n      try {\n        const content = fs.readFileSync(filePath, 'utf-8');\n        const data = JSON.parse(content) as Record<string, unknown>;\n        this.translations.set(locale, data);\n      } catch {\n        // Skip files that can't be parsed\n      }\n    }\n  }\n\n  private resolveFromLocale(key: string, locale: string): string | undefined {\n    const data = this.translations.get(locale);\n    if (!data) return undefined;\n    return resolveKey(data, key);\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport type { IHttpServer, IHttpRequest, IHttpResponse } from '@objectstack/spec/contracts';\nimport type { II18nService } from '@objectstack/spec/contracts';\nimport { FileI18nAdapter } from './file-i18n-adapter.js';\nimport type { FileI18nAdapterOptions } from './file-i18n-adapter.js';\n\n/**\n * Configuration options for the I18nServicePlugin.\n */\nexport interface I18nServicePluginOptions {\n  /** Default locale (default: 'en') */\n  defaultLocale?: string;\n  /** Directory containing locale JSON files */\n  localesDir?: string;\n  /** Fallback locale for missing translations */\n  fallbackLocale?: string;\n  /**\n   * Whether to automatically register i18n REST routes with the HTTP server.\n   * When true (default), the plugin registers `/api/v1/i18n/*` endpoints\n   * via the `kernel:ready` hook. When false or no HTTP server is available,\n   * routes are skipped but the i18n service is still available via the kernel.\n   * @default true\n   */\n  registerRoutes?: boolean;\n  /**\n   * Base path for i18n REST routes.\n   * @default '/api/v1/i18n'\n   */\n  basePath?: string;\n}\n\n/**\n * I18nServicePlugin — Production II18nService implementation.\n *\n * Registers an i18n service with the kernel during the init phase,\n * and self-registers REST endpoints (`/api/v1/i18n/*`) with the HTTP\n * server during the `kernel:ready` hook.\n *\n * REST route self-registration follows the same autonomous plugin pattern\n * used by AuthPlugin, WorkflowPlugin, and other service plugins — RestServer\n * is not involved.\n *\n * @example\n * ```ts\n * import { ObjectKernel } from '@objectstack/core';\n * import { I18nServicePlugin } from '@objectstack/service-i18n';\n *\n * const kernel = new ObjectKernel();\n * kernel.use(new I18nServicePlugin({\n *   defaultLocale: 'en',\n *   localesDir: './i18n',\n *   fallbackLocale: 'en',\n * }));\n * await kernel.bootstrap();\n *\n * const i18n = kernel.getService('i18n');\n * i18n.t('objects.account.label', 'en'); // 'Account'\n * ```\n */\nexport class I18nServicePlugin implements Plugin {\n  name = 'com.objectstack.service.i18n';\n  version = '1.0.0';\n  type = 'standard';\n\n  private readonly options: I18nServicePluginOptions;\n  private i18n: II18nService | null = null;\n\n  constructor(options: I18nServicePluginOptions = {}) {\n    this.options = options;\n  }\n\n  async init(ctx: PluginContext): Promise<void> {\n    const adapterOptions: FileI18nAdapterOptions = {\n      defaultLocale: this.options.defaultLocale,\n      localesDir: this.options.localesDir,\n      fallbackLocale: this.options.fallbackLocale,\n    };\n\n    this.i18n = new FileI18nAdapter(adapterOptions);\n    ctx.registerService('i18n', this.i18n);\n    ctx.logger.info(\n      `I18nServicePlugin: registered file-based i18n adapter (default: ${this.i18n.getDefaultLocale?.() ?? 'en'})`,\n    );\n  }\n\n  async start(ctx: PluginContext): Promise<void> {\n    // Defer HTTP route registration to kernel:ready hook.\n    // This ensures all plugins (including HonoServerPlugin) have completed\n    // their init and start phases before we attempt to look up the\n    // http-server service — making I18nServicePlugin resilient to plugin\n    // loading order.\n    if (this.options.registerRoutes !== false) {\n      ctx.hook('kernel:ready', async () => {\n        let httpServer: IHttpServer | null = null;\n        try {\n          httpServer = ctx.getService<IHttpServer>('http-server');\n        } catch {\n          // Service not found — expected in MSW/mock mode\n        }\n\n        if (httpServer) {\n          this.registerI18nRoutes(httpServer, ctx);\n        } else {\n          ctx.logger.warn(\n            'No HTTP server available — i18n routes not registered. ' +\n            'i18n service is still available programmatically via kernel.getService(\"i18n\").'\n          );\n        }\n      });\n    }\n  }\n\n  /**\n   * Register i18n REST routes with the HTTP server.\n   *\n   * Routes:\n   * - GET /api/v1/i18n/locales           → list available locales\n   * - GET /api/v1/i18n/translations/:locale → get translations for a locale\n   * - GET /api/v1/i18n/labels/:object/:locale → get field labels for an object\n   */\n  private registerI18nRoutes(httpServer: IHttpServer, ctx: PluginContext): void {\n    if (!this.i18n) return;\n\n    const basePath = this.options.basePath || '/api/v1/i18n';\n    const i18n = this.i18n;\n\n    // GET /i18n/locales\n    httpServer.get(`${basePath}/locales`, async (_req: IHttpRequest, res: IHttpResponse) => {\n      try {\n        const locales = i18n.getLocales();\n        const defaultLocale = i18n.getDefaultLocale?.() ?? 'en';\n        res.json({\n          data: {\n            locales: locales.map((code) => ({\n              code,\n              label: code,\n              isDefault: code === defaultLocale,\n            })),\n          },\n        });\n      } catch (error: any) {\n        res.status(500).json({ error: error.message });\n      }\n    });\n\n    // GET /i18n/translations/:locale\n    httpServer.get(`${basePath}/translations/:locale`, async (req: IHttpRequest, res: IHttpResponse) => {\n      try {\n        const locale = req.params.locale;\n        if (!locale) {\n          res.status(400).json({ error: 'Missing locale parameter' });\n          return;\n        }\n        const translations = i18n.getTranslations(locale);\n        res.json({ data: { locale, translations } });\n      } catch (error: any) {\n        res.status(500).json({ error: error.message });\n      }\n    });\n\n    // GET /i18n/labels/:object/:locale\n    httpServer.get(`${basePath}/labels/:object/:locale`, async (req: IHttpRequest, res: IHttpResponse) => {\n      try {\n        const objectName = req.params.object;\n        const locale = req.params.locale;\n        if (!objectName || !locale) {\n          res.status(400).json({ error: 'Missing object or locale parameter' });\n          return;\n        }\n        // Some implementations may provide a dedicated getFieldLabels method\n        const hasGetFieldLabels = 'getFieldLabels' in i18n\n          && typeof (i18n as Record<string, unknown>)['getFieldLabels'] === 'function';\n        if (hasGetFieldLabels) {\n          const labels = (i18n as II18nService & { getFieldLabels(obj: string, loc: string): Record<string, string> })\n            .getFieldLabels(objectName, locale);\n          res.json({ data: { object: objectName, locale, labels } });\n        } else {\n          // Fallback: derive field labels from full translation bundle\n          const translations = i18n.getTranslations(locale);\n          const prefix = `o.${objectName}.fields.`;\n          const labels: Record<string, string> = {};\n          for (const [key, value] of Object.entries(translations)) {\n            if (key.startsWith(prefix)) {\n              labels[key.substring(prefix.length)] = value as string;\n            }\n          }\n          res.json({ data: { object: objectName, locale, labels } });\n        }\n      } catch (error: any) {\n        res.status(500).json({ error: error.message });\n      }\n    });\n\n    ctx.logger.info(`I18n routes registered: ${basePath}/locales, ${basePath}/translations/:locale, ${basePath}/labels/:object/:locale`);\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/file-i18n-adapter.ts","../src/i18n-service-plugin.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nexport { I18nServicePlugin } from './i18n-service-plugin.js';\nexport type { I18nServicePluginOptions } from './i18n-service-plugin.js';\nexport { FileI18nAdapter } from './file-i18n-adapter.js';\nexport type { FileI18nAdapterOptions } from './file-i18n-adapter.js';\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { II18nService } from '@objectstack/spec/contracts';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\n\n/**\n * Configuration options for FileI18nAdapter.\n */\nexport interface FileI18nAdapterOptions {\n  /** Default locale (e.g. 'en') */\n  defaultLocale?: string;\n  /** Directory containing locale files (JSON). Each file should be named `{locale}.json`. */\n  localesDir?: string;\n  /** Fallback locale when a key is not found in the requested locale */\n  fallbackLocale?: string;\n}\n\n/**\n * Resolve a nested key in a translations object using dot notation.\n *\n * @param data - Translation data object\n * @param key - Dot-separated key (e.g. 'objects.account.label')\n * @returns The resolved string value, or undefined if not found\n */\nfunction resolveKey(data: Record<string, unknown>, key: string): string | undefined {\n  const parts = key.split('.');\n  let current: unknown = data;\n  for (const part of parts) {\n    if (current == null || typeof current !== 'object') return undefined;\n    current = (current as Record<string, unknown>)[part];\n  }\n  return typeof current === 'string' ? current : undefined;\n}\n\n/**\n * Deep-merge two plain objects recursively.\n * Arrays and non-plain-object values from `source` overwrite those in `target`.\n */\nfunction deepMerge(\n  target: Record<string, unknown>,\n  source: Record<string, unknown>,\n): Record<string, unknown> {\n  const result: Record<string, unknown> = { ...target };\n  for (const key of Object.keys(source)) {\n    const tVal = target[key];\n    const sVal = source[key];\n    if (\n      tVal && sVal\n      && typeof tVal === 'object' && !Array.isArray(tVal)\n      && typeof sVal === 'object' && !Array.isArray(sVal)\n    ) {\n      result[key] = deepMerge(\n        tVal as Record<string, unknown>,\n        sVal as Record<string, unknown>,\n      );\n    } else {\n      result[key] = sVal;\n    }\n  }\n  return result;\n}\n\n/**\n * Interpolate parameters into a translated string.\n * Replaces `{{paramName}}` with the corresponding value from params.\n *\n * @param template - Template string with `{{key}}` placeholders\n * @param params - Parameter map\n * @returns Interpolated string\n */\nfunction interpolate(template: string, params: Record<string, unknown>): string {\n  return template.replace(/\\{\\{(\\w+)\\}\\}/g, (_match, key: string) => {\n    return params[key] != null ? String(params[key]) : `{{${key}}}`;\n  });\n}\n\n/**\n * File-based I18n adapter implementing II18nService.\n *\n * Loads JSON translation files from a directory on disk.\n * Each file should be named `{locale}.json` and contain a flat or nested\n * key-value map of translations.\n *\n * Supports:\n * - Dot-notation key resolution (e.g. 'objects.account.label')\n * - Parameter interpolation via `{{paramName}}` syntax\n * - Fallback locale for missing translations\n * - Runtime translation loading via loadTranslations()\n *\n * Suitable for server-side rendering, CLI tools, and development environments.\n *\n * @example\n * ```ts\n * const i18n = new FileI18nAdapter({\n *   defaultLocale: 'en',\n *   localesDir: './i18n',\n *   fallbackLocale: 'en',\n * });\n *\n * i18n.t('objects.account.label', 'zh-CN'); // '客户'\n * i18n.t('greeting', 'en', { name: 'World' }); // 'Hello, World!'\n * ```\n */\nexport class FileI18nAdapter implements II18nService {\n  private readonly translations = new Map<string, Record<string, unknown>>();\n  private defaultLocale: string;\n  private readonly fallbackLocale: string | undefined;\n\n  constructor(options: FileI18nAdapterOptions = {}) {\n    this.defaultLocale = options.defaultLocale ?? 'en';\n    this.fallbackLocale = options.fallbackLocale;\n\n    if (options.localesDir) {\n      this.loadFromDirectory(options.localesDir);\n    }\n  }\n\n  t(key: string, locale: string, params?: Record<string, unknown>): string {\n    // Try requested locale\n    let value = this.resolveFromLocale(key, locale);\n\n    // Try fallback locale\n    if (value === undefined && this.fallbackLocale && this.fallbackLocale !== locale) {\n      value = this.resolveFromLocale(key, this.fallbackLocale);\n    }\n\n    // Return key if not found\n    if (value === undefined) return key;\n\n    // Interpolate parameters\n    if (params && Object.keys(params).length > 0) {\n      return interpolate(value, params);\n    }\n\n    return value;\n  }\n\n  getTranslations(locale: string): Record<string, unknown> {\n    return this.translations.get(locale) ?? {};\n  }\n\n  loadTranslations(locale: string, translations: Record<string, unknown>): void {\n    const existing = this.translations.get(locale);\n    if (existing) {\n      // Deep-merge so multiple plugins can contribute to the same nested keys\n      // (e.g. each plugin adds its own objects under `objects.*`)\n      this.translations.set(locale, deepMerge(existing, translations));\n    } else {\n      this.translations.set(locale, { ...translations });\n    }\n  }\n\n  getLocales(): string[] {\n    return Array.from(this.translations.keys());\n  }\n\n  getDefaultLocale(): string {\n    return this.defaultLocale;\n  }\n\n  setDefaultLocale(locale: string): void {\n    this.defaultLocale = locale;\n  }\n\n  /**\n   * Load all JSON translation files from a directory.\n   * Each file should be named `{locale}.json`.\n   */\n  private loadFromDirectory(dir: string): void {\n    if (!fs.existsSync(dir)) return;\n\n    const files = fs.readdirSync(dir);\n    for (const file of files) {\n      if (!file.endsWith('.json')) continue;\n      const locale = file.replace(/\\.json$/, '');\n      const filePath = path.join(dir, file);\n      try {\n        const content = fs.readFileSync(filePath, 'utf-8');\n        const data = JSON.parse(content) as Record<string, unknown>;\n        this.translations.set(locale, data);\n      } catch {\n        // Skip files that can't be parsed\n      }\n    }\n  }\n\n  private resolveFromLocale(key: string, locale: string): string | undefined {\n    const data = this.translations.get(locale);\n    if (!data) return undefined;\n    return resolveKey(data, key);\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport type { IHttpServer, IHttpRequest, IHttpResponse } from '@objectstack/spec/contracts';\nimport type { II18nService } from '@objectstack/spec/contracts';\nimport { FileI18nAdapter } from './file-i18n-adapter.js';\nimport type { FileI18nAdapterOptions } from './file-i18n-adapter.js';\n\n/**\n * Configuration options for the I18nServicePlugin.\n */\nexport interface I18nServicePluginOptions {\n  /** Default locale (default: 'en') */\n  defaultLocale?: string;\n  /** Directory containing locale JSON files */\n  localesDir?: string;\n  /** Fallback locale for missing translations */\n  fallbackLocale?: string;\n  /**\n   * Whether to automatically register i18n REST routes with the HTTP server.\n   * When true (default), the plugin registers `/api/v1/i18n/*` endpoints\n   * via the `kernel:ready` hook. When false or no HTTP server is available,\n   * routes are skipped but the i18n service is still available via the kernel.\n   * @default true\n   */\n  registerRoutes?: boolean;\n  /**\n   * Base path for i18n REST routes.\n   * @default '/api/v1/i18n'\n   */\n  basePath?: string;\n}\n\n/**\n * I18nServicePlugin — Production II18nService implementation.\n *\n * Registers an i18n service with the kernel during the init phase,\n * and self-registers REST endpoints (`/api/v1/i18n/*`) with the HTTP\n * server during the `kernel:ready` hook.\n *\n * REST route self-registration follows the same autonomous plugin pattern\n * used by AuthPlugin, WorkflowPlugin, and other service plugins — RestServer\n * is not involved.\n *\n * @example\n * ```ts\n * import { ObjectKernel } from '@objectstack/core';\n * import { I18nServicePlugin } from '@objectstack/service-i18n';\n *\n * const kernel = new ObjectKernel();\n * kernel.use(new I18nServicePlugin({\n *   defaultLocale: 'en',\n *   localesDir: './i18n',\n *   fallbackLocale: 'en',\n * }));\n * await kernel.bootstrap();\n *\n * const i18n = kernel.getService('i18n');\n * i18n.t('objects.account.label', 'en'); // 'Account'\n * ```\n */\nexport class I18nServicePlugin implements Plugin {\n  name = 'com.objectstack.service.i18n';\n  version = '1.0.0';\n  type = 'standard';\n\n  private readonly options: I18nServicePluginOptions;\n  private i18n: II18nService | null = null;\n\n  constructor(options: I18nServicePluginOptions = {}) {\n    this.options = options;\n  }\n\n  async init(ctx: PluginContext): Promise<void> {\n    const adapterOptions: FileI18nAdapterOptions = {\n      defaultLocale: this.options.defaultLocale,\n      localesDir: this.options.localesDir,\n      fallbackLocale: this.options.fallbackLocale,\n    };\n\n    this.i18n = new FileI18nAdapter(adapterOptions);\n    ctx.registerService('i18n', this.i18n);\n    ctx.logger.info(\n      `I18nServicePlugin: registered file-based i18n adapter (default: ${this.i18n.getDefaultLocale?.() ?? 'en'})`,\n    );\n  }\n\n  async start(ctx: PluginContext): Promise<void> {\n    // Defer HTTP route registration to kernel:ready hook.\n    // This ensures all plugins (including HonoServerPlugin) have completed\n    // their init and start phases before we attempt to look up the\n    // http-server service — making I18nServicePlugin resilient to plugin\n    // loading order.\n    if (this.options.registerRoutes !== false) {\n      ctx.hook('kernel:ready', async () => {\n        let httpServer: IHttpServer | null = null;\n        try {\n          httpServer = ctx.getService<IHttpServer>('http-server');\n        } catch {\n          // Service not found — expected in MSW/mock mode\n        }\n\n        if (httpServer) {\n          this.registerI18nRoutes(httpServer, ctx);\n        } else {\n          ctx.logger.warn(\n            'No HTTP server available — i18n routes not registered. ' +\n            'i18n service is still available programmatically via kernel.getService(\"i18n\").'\n          );\n        }\n      });\n    }\n  }\n\n  /**\n   * Register i18n REST routes with the HTTP server.\n   *\n   * Routes:\n   * - GET /api/v1/i18n/locales           → list available locales\n   * - GET /api/v1/i18n/translations/:locale → get translations for a locale\n   * - GET /api/v1/i18n/labels/:object/:locale → get field labels for an object\n   */\n  private registerI18nRoutes(httpServer: IHttpServer, ctx: PluginContext): void {\n    if (!this.i18n) return;\n\n    const basePath = this.options.basePath || '/api/v1/i18n';\n    const i18n = this.i18n;\n\n    // GET /i18n/locales\n    httpServer.get(`${basePath}/locales`, async (_req: IHttpRequest, res: IHttpResponse) => {\n      try {\n        const locales = i18n.getLocales();\n        const defaultLocale = i18n.getDefaultLocale?.() ?? 'en';\n        res.json({\n          data: {\n            locales: locales.map((code) => ({\n              code,\n              label: code,\n              isDefault: code === defaultLocale,\n            })),\n          },\n        });\n      } catch (error: any) {\n        res.status(500).json({ error: error.message });\n      }\n    });\n\n    // GET /i18n/translations/:locale\n    httpServer.get(`${basePath}/translations/:locale`, async (req: IHttpRequest, res: IHttpResponse) => {\n      try {\n        const locale = req.params.locale;\n        if (!locale) {\n          res.status(400).json({ error: 'Missing locale parameter' });\n          return;\n        }\n        const translations = i18n.getTranslations(locale);\n        res.json({ data: { locale, translations } });\n      } catch (error: any) {\n        res.status(500).json({ error: error.message });\n      }\n    });\n\n    // GET /i18n/labels/:object/:locale\n    httpServer.get(`${basePath}/labels/:object/:locale`, async (req: IHttpRequest, res: IHttpResponse) => {\n      try {\n        const objectName = req.params.object;\n        const locale = req.params.locale;\n        if (!objectName || !locale) {\n          res.status(400).json({ error: 'Missing object or locale parameter' });\n          return;\n        }\n        // Some implementations may provide a dedicated getFieldLabels method\n        const hasGetFieldLabels = 'getFieldLabels' in i18n\n          && typeof (i18n as Record<string, unknown>)['getFieldLabels'] === 'function';\n        if (hasGetFieldLabels) {\n          const labels = (i18n as II18nService & { getFieldLabels(obj: string, loc: string): Record<string, string> })\n            .getFieldLabels(objectName, locale);\n          res.json({ data: { object: objectName, locale, labels } });\n        } else {\n          // Fallback: derive field labels from full translation bundle\n          const translations = i18n.getTranslations(locale);\n          const prefix = `o.${objectName}.fields.`;\n          const labels: Record<string, string> = {};\n          for (const [key, value] of Object.entries(translations)) {\n            if (key.startsWith(prefix)) {\n              labels[key.substring(prefix.length)] = value as string;\n            }\n          }\n          res.json({ data: { object: objectName, locale, labels } });\n        }\n      } catch (error: any) {\n        res.status(500).json({ error: error.message });\n      }\n    });\n\n    ctx.logger.info(`I18n routes registered: ${basePath}/locales, ${basePath}/translations/:locale, ${basePath}/labels/:object/:locale`);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.js

@@ -10,6 +10,22 @@ function resolveKey(data, key) {
   }
   return typeof current === "string" ? current : void 0;
 }
+function deepMerge(target, source) {
+  const result = { ...target };
+  for (const key of Object.keys(source)) {
+    const tVal = target[key];
+    const sVal = source[key];
+    if (tVal && sVal && typeof tVal === "object" && !Array.isArray(tVal) && typeof sVal === "object" && !Array.isArray(sVal)) {
+      result[key] = deepMerge(
+        tVal,
+        sVal
+      );
+    } else {
+      result[key] = sVal;
+    }
+  }
+  return result;
+}
 function interpolate(template, params) {
   return template.replace(/\{\{(\w+)\}\}/g, (_match, key) => {
     return params[key] != null ? String(params[key]) : `{{${key}}}`;
@@ -41,7 +57,7 @@ var FileI18nAdapter = class {
   loadTranslations(locale, translations) {
     const existing = this.translations.get(locale);
     if (existing) {
-      this.translations.set(locale, { ...existing, ...translations });
+      this.translations.set(locale, deepMerge(existing, translations));
     } else {
       this.translations.set(locale, { ...translations });
     }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/file-i18n-adapter.ts","../src/i18n-service-plugin.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { II18nService } from '@objectstack/spec/contracts';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\n\n/**\n * Configuration options for FileI18nAdapter.\n */\nexport interface FileI18nAdapterOptions {\n  /** Default locale (e.g. 'en') */\n  defaultLocale?: string;\n  /** Directory containing locale files (JSON). Each file should be named `{locale}.json`. */\n  localesDir?: string;\n  /** Fallback locale when a key is not found in the requested locale */\n  fallbackLocale?: string;\n}\n\n/**\n * Resolve a nested key in a translations object using dot notation.\n *\n * @param data - Translation data object\n * @param key - Dot-separated key (e.g. 'objects.account.label')\n * @returns The resolved string value, or undefined if not found\n */\nfunction resolveKey(data: Record<string, unknown>, key: string): string | undefined {\n  const parts = key.split('.');\n  let current: unknown = data;\n  for (const part of parts) {\n    if (current == null || typeof current !== 'object') return undefined;\n    current = (current as Record<string, unknown>)[part];\n  }\n  return typeof current === 'string' ? current : undefined;\n}\n\n/**\n * Interpolate parameters into a translated string.\n * Replaces `{{paramName}}` with the corresponding value from params.\n *\n * @param template - Template string with `{{key}}` placeholders\n * @param params - Parameter map\n * @returns Interpolated string\n */\nfunction interpolate(template: string, params: Record<string, unknown>): string {\n  return template.replace(/\\{\\{(\\w+)\\}\\}/g, (_match, key: string) => {\n    return params[key] != null ? String(params[key]) : `{{${key}}}`;\n  });\n}\n\n/**\n * File-based I18n adapter implementing II18nService.\n *\n * Loads JSON translation files from a directory on disk.\n * Each file should be named `{locale}.json` and contain a flat or nested\n * key-value map of translations.\n *\n * Supports:\n * - Dot-notation key resolution (e.g. 'objects.account.label')\n * - Parameter interpolation via `{{paramName}}` syntax\n * - Fallback locale for missing translations\n * - Runtime translation loading via loadTranslations()\n *\n * Suitable for server-side rendering, CLI tools, and development environments.\n *\n * @example\n * ```ts\n * const i18n = new FileI18nAdapter({\n *   defaultLocale: 'en',\n *   localesDir: './i18n',\n *   fallbackLocale: 'en',\n * });\n *\n * i18n.t('objects.account.label', 'zh-CN'); // '客户'\n * i18n.t('greeting', 'en', { name: 'World' }); // 'Hello, World!'\n * ```\n */\nexport class FileI18nAdapter implements II18nService {\n  private readonly translations = new Map<string, Record<string, unknown>>();\n  private defaultLocale: string;\n  private readonly fallbackLocale: string | undefined;\n\n  constructor(options: FileI18nAdapterOptions = {}) {\n    this.defaultLocale = options.defaultLocale ?? 'en';\n    this.fallbackLocale = options.fallbackLocale;\n\n    if (options.localesDir) {\n      this.loadFromDirectory(options.localesDir);\n    }\n  }\n\n  t(key: string, locale: string, params?: Record<string, unknown>): string {\n    // Try requested locale\n    let value = this.resolveFromLocale(key, locale);\n\n    // Try fallback locale\n    if (value === undefined && this.fallbackLocale && this.fallbackLocale !== locale) {\n      value = this.resolveFromLocale(key, this.fallbackLocale);\n    }\n\n    // Return key if not found\n    if (value === undefined) return key;\n\n    // Interpolate parameters\n    if (params && Object.keys(params).length > 0) {\n      return interpolate(value, params);\n    }\n\n    return value;\n  }\n\n  getTranslations(locale: string): Record<string, unknown> {\n    return this.translations.get(locale) ?? {};\n  }\n\n  loadTranslations(locale: string, translations: Record<string, unknown>): void {\n    const existing = this.translations.get(locale);\n    if (existing) {\n      // Merge into existing translations\n      this.translations.set(locale, { ...existing, ...translations });\n    } else {\n      this.translations.set(locale, { ...translations });\n    }\n  }\n\n  getLocales(): string[] {\n    return Array.from(this.translations.keys());\n  }\n\n  getDefaultLocale(): string {\n    return this.defaultLocale;\n  }\n\n  setDefaultLocale(locale: string): void {\n    this.defaultLocale = locale;\n  }\n\n  /**\n   * Load all JSON translation files from a directory.\n   * Each file should be named `{locale}.json`.\n   */\n  private loadFromDirectory(dir: string): void {\n    if (!fs.existsSync(dir)) return;\n\n    const files = fs.readdirSync(dir);\n    for (const file of files) {\n      if (!file.endsWith('.json')) continue;\n      const locale = file.replace(/\\.json$/, '');\n      const filePath = path.join(dir, file);\n      try {\n        const content = fs.readFileSync(filePath, 'utf-8');\n        const data = JSON.parse(content) as Record<string, unknown>;\n        this.translations.set(locale, data);\n      } catch {\n        // Skip files that can't be parsed\n      }\n    }\n  }\n\n  private resolveFromLocale(key: string, locale: string): string | undefined {\n    const data = this.translations.get(locale);\n    if (!data) return undefined;\n    return resolveKey(data, key);\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport type { IHttpServer, IHttpRequest, IHttpResponse } from '@objectstack/spec/contracts';\nimport type { II18nService } from '@objectstack/spec/contracts';\nimport { FileI18nAdapter } from './file-i18n-adapter.js';\nimport type { FileI18nAdapterOptions } from './file-i18n-adapter.js';\n\n/**\n * Configuration options for the I18nServicePlugin.\n */\nexport interface I18nServicePluginOptions {\n  /** Default locale (default: 'en') */\n  defaultLocale?: string;\n  /** Directory containing locale JSON files */\n  localesDir?: string;\n  /** Fallback locale for missing translations */\n  fallbackLocale?: string;\n  /**\n   * Whether to automatically register i18n REST routes with the HTTP server.\n   * When true (default), the plugin registers `/api/v1/i18n/*` endpoints\n   * via the `kernel:ready` hook. When false or no HTTP server is available,\n   * routes are skipped but the i18n service is still available via the kernel.\n   * @default true\n   */\n  registerRoutes?: boolean;\n  /**\n   * Base path for i18n REST routes.\n   * @default '/api/v1/i18n'\n   */\n  basePath?: string;\n}\n\n/**\n * I18nServicePlugin — Production II18nService implementation.\n *\n * Registers an i18n service with the kernel during the init phase,\n * and self-registers REST endpoints (`/api/v1/i18n/*`) with the HTTP\n * server during the `kernel:ready` hook.\n *\n * REST route self-registration follows the same autonomous plugin pattern\n * used by AuthPlugin, WorkflowPlugin, and other service plugins — RestServer\n * is not involved.\n *\n * @example\n * ```ts\n * import { ObjectKernel } from '@objectstack/core';\n * import { I18nServicePlugin } from '@objectstack/service-i18n';\n *\n * const kernel = new ObjectKernel();\n * kernel.use(new I18nServicePlugin({\n *   defaultLocale: 'en',\n *   localesDir: './i18n',\n *   fallbackLocale: 'en',\n * }));\n * await kernel.bootstrap();\n *\n * const i18n = kernel.getService('i18n');\n * i18n.t('objects.account.label', 'en'); // 'Account'\n * ```\n */\nexport class I18nServicePlugin implements Plugin {\n  name = 'com.objectstack.service.i18n';\n  version = '1.0.0';\n  type = 'standard';\n\n  private readonly options: I18nServicePluginOptions;\n  private i18n: II18nService | null = null;\n\n  constructor(options: I18nServicePluginOptions = {}) {\n    this.options = options;\n  }\n\n  async init(ctx: PluginContext): Promise<void> {\n    const adapterOptions: FileI18nAdapterOptions = {\n      defaultLocale: this.options.defaultLocale,\n      localesDir: this.options.localesDir,\n      fallbackLocale: this.options.fallbackLocale,\n    };\n\n    this.i18n = new FileI18nAdapter(adapterOptions);\n    ctx.registerService('i18n', this.i18n);\n    ctx.logger.info(\n      `I18nServicePlugin: registered file-based i18n adapter (default: ${this.i18n.getDefaultLocale?.() ?? 'en'})`,\n    );\n  }\n\n  async start(ctx: PluginContext): Promise<void> {\n    // Defer HTTP route registration to kernel:ready hook.\n    // This ensures all plugins (including HonoServerPlugin) have completed\n    // their init and start phases before we attempt to look up the\n    // http-server service — making I18nServicePlugin resilient to plugin\n    // loading order.\n    if (this.options.registerRoutes !== false) {\n      ctx.hook('kernel:ready', async () => {\n        let httpServer: IHttpServer | null = null;\n        try {\n          httpServer = ctx.getService<IHttpServer>('http-server');\n        } catch {\n          // Service not found — expected in MSW/mock mode\n        }\n\n        if (httpServer) {\n          this.registerI18nRoutes(httpServer, ctx);\n        } else {\n          ctx.logger.warn(\n            'No HTTP server available — i18n routes not registered. ' +\n            'i18n service is still available programmatically via kernel.getService(\"i18n\").'\n          );\n        }\n      });\n    }\n  }\n\n  /**\n   * Register i18n REST routes with the HTTP server.\n   *\n   * Routes:\n   * - GET /api/v1/i18n/locales           → list available locales\n   * - GET /api/v1/i18n/translations/:locale → get translations for a locale\n   * - GET /api/v1/i18n/labels/:object/:locale → get field labels for an object\n   */\n  private registerI18nRoutes(httpServer: IHttpServer, ctx: PluginContext): void {\n    if (!this.i18n) return;\n\n    const basePath = this.options.basePath || '/api/v1/i18n';\n    const i18n = this.i18n;\n\n    // GET /i18n/locales\n    httpServer.get(`${basePath}/locales`, async (_req: IHttpRequest, res: IHttpResponse) => {\n      try {\n        const locales = i18n.getLocales();\n        const defaultLocale = i18n.getDefaultLocale?.() ?? 'en';\n        res.json({\n          data: {\n            locales: locales.map((code) => ({\n              code,\n              label: code,\n              isDefault: code === defaultLocale,\n            })),\n          },\n        });\n      } catch (error: any) {\n        res.status(500).json({ error: error.message });\n      }\n    });\n\n    // GET /i18n/translations/:locale\n    httpServer.get(`${basePath}/translations/:locale`, async (req: IHttpRequest, res: IHttpResponse) => {\n      try {\n        const locale = req.params.locale;\n        if (!locale) {\n          res.status(400).json({ error: 'Missing locale parameter' });\n          return;\n        }\n        const translations = i18n.getTranslations(locale);\n        res.json({ data: { locale, translations } });\n      } catch (error: any) {\n        res.status(500).json({ error: error.message });\n      }\n    });\n\n    // GET /i18n/labels/:object/:locale\n    httpServer.get(`${basePath}/labels/:object/:locale`, async (req: IHttpRequest, res: IHttpResponse) => {\n      try {\n        const objectName = req.params.object;\n        const locale = req.params.locale;\n        if (!objectName || !locale) {\n          res.status(400).json({ error: 'Missing object or locale parameter' });\n          return;\n        }\n        // Some implementations may provide a dedicated getFieldLabels method\n        const hasGetFieldLabels = 'getFieldLabels' in i18n\n          && typeof (i18n as Record<string, unknown>)['getFieldLabels'] === 'function';\n        if (hasGetFieldLabels) {\n          const labels = (i18n as II18nService & { getFieldLabels(obj: string, loc: string): Record<string, string> })\n            .getFieldLabels(objectName, locale);\n          res.json({ data: { object: objectName, locale, labels } });\n        } else {\n          // Fallback: derive field labels from full translation bundle\n          const translations = i18n.getTranslations(locale);\n          const prefix = `o.${objectName}.fields.`;\n          const labels: Record<string, string> = {};\n          for (const [key, value] of Object.entries(translations)) {\n            if (key.startsWith(prefix)) {\n              labels[key.substring(prefix.length)] = value as string;\n            }\n          }\n          res.json({ data: { object: objectName, locale, labels } });\n        }\n      } catch (error: any) {\n        res.status(500).json({ error: error.message });\n      }\n    });\n\n    ctx.logger.info(`I18n routes registered: ${basePath}/locales, ${basePath}/translations/:locale, ${basePath}/labels/:object/:locale`);\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/file-i18n-adapter.ts","../src/i18n-service-plugin.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { II18nService } from '@objectstack/spec/contracts';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\n\n/**\n * Configuration options for FileI18nAdapter.\n */\nexport interface FileI18nAdapterOptions {\n  /** Default locale (e.g. 'en') */\n  defaultLocale?: string;\n  /** Directory containing locale files (JSON). Each file should be named `{locale}.json`. */\n  localesDir?: string;\n  /** Fallback locale when a key is not found in the requested locale */\n  fallbackLocale?: string;\n}\n\n/**\n * Resolve a nested key in a translations object using dot notation.\n *\n * @param data - Translation data object\n * @param key - Dot-separated key (e.g. 'objects.account.label')\n * @returns The resolved string value, or undefined if not found\n */\nfunction resolveKey(data: Record<string, unknown>, key: string): string | undefined {\n  const parts = key.split('.');\n  let current: unknown = data;\n  for (const part of parts) {\n    if (current == null || typeof current !== 'object') return undefined;\n    current = (current as Record<string, unknown>)[part];\n  }\n  return typeof current === 'string' ? current : undefined;\n}\n\n/**\n * Deep-merge two plain objects recursively.\n * Arrays and non-plain-object values from `source` overwrite those in `target`.\n */\nfunction deepMerge(\n  target: Record<string, unknown>,\n  source: Record<string, unknown>,\n): Record<string, unknown> {\n  const result: Record<string, unknown> = { ...target };\n  for (const key of Object.keys(source)) {\n    const tVal = target[key];\n    const sVal = source[key];\n    if (\n      tVal && sVal\n      && typeof tVal === 'object' && !Array.isArray(tVal)\n      && typeof sVal === 'object' && !Array.isArray(sVal)\n    ) {\n      result[key] = deepMerge(\n        tVal as Record<string, unknown>,\n        sVal as Record<string, unknown>,\n      );\n    } else {\n      result[key] = sVal;\n    }\n  }\n  return result;\n}\n\n/**\n * Interpolate parameters into a translated string.\n * Replaces `{{paramName}}` with the corresponding value from params.\n *\n * @param template - Template string with `{{key}}` placeholders\n * @param params - Parameter map\n * @returns Interpolated string\n */\nfunction interpolate(template: string, params: Record<string, unknown>): string {\n  return template.replace(/\\{\\{(\\w+)\\}\\}/g, (_match, key: string) => {\n    return params[key] != null ? String(params[key]) : `{{${key}}}`;\n  });\n}\n\n/**\n * File-based I18n adapter implementing II18nService.\n *\n * Loads JSON translation files from a directory on disk.\n * Each file should be named `{locale}.json` and contain a flat or nested\n * key-value map of translations.\n *\n * Supports:\n * - Dot-notation key resolution (e.g. 'objects.account.label')\n * - Parameter interpolation via `{{paramName}}` syntax\n * - Fallback locale for missing translations\n * - Runtime translation loading via loadTranslations()\n *\n * Suitable for server-side rendering, CLI tools, and development environments.\n *\n * @example\n * ```ts\n * const i18n = new FileI18nAdapter({\n *   defaultLocale: 'en',\n *   localesDir: './i18n',\n *   fallbackLocale: 'en',\n * });\n *\n * i18n.t('objects.account.label', 'zh-CN'); // '客户'\n * i18n.t('greeting', 'en', { name: 'World' }); // 'Hello, World!'\n * ```\n */\nexport class FileI18nAdapter implements II18nService {\n  private readonly translations = new Map<string, Record<string, unknown>>();\n  private defaultLocale: string;\n  private readonly fallbackLocale: string | undefined;\n\n  constructor(options: FileI18nAdapterOptions = {}) {\n    this.defaultLocale = options.defaultLocale ?? 'en';\n    this.fallbackLocale = options.fallbackLocale;\n\n    if (options.localesDir) {\n      this.loadFromDirectory(options.localesDir);\n    }\n  }\n\n  t(key: string, locale: string, params?: Record<string, unknown>): string {\n    // Try requested locale\n    let value = this.resolveFromLocale(key, locale);\n\n    // Try fallback locale\n    if (value === undefined && this.fallbackLocale && this.fallbackLocale !== locale) {\n      value = this.resolveFromLocale(key, this.fallbackLocale);\n    }\n\n    // Return key if not found\n    if (value === undefined) return key;\n\n    // Interpolate parameters\n    if (params && Object.keys(params).length > 0) {\n      return interpolate(value, params);\n    }\n\n    return value;\n  }\n\n  getTranslations(locale: string): Record<string, unknown> {\n    return this.translations.get(locale) ?? {};\n  }\n\n  loadTranslations(locale: string, translations: Record<string, unknown>): void {\n    const existing = this.translations.get(locale);\n    if (existing) {\n      // Deep-merge so multiple plugins can contribute to the same nested keys\n      // (e.g. each plugin adds its own objects under `objects.*`)\n      this.translations.set(locale, deepMerge(existing, translations));\n    } else {\n      this.translations.set(locale, { ...translations });\n    }\n  }\n\n  getLocales(): string[] {\n    return Array.from(this.translations.keys());\n  }\n\n  getDefaultLocale(): string {\n    return this.defaultLocale;\n  }\n\n  setDefaultLocale(locale: string): void {\n    this.defaultLocale = locale;\n  }\n\n  /**\n   * Load all JSON translation files from a directory.\n   * Each file should be named `{locale}.json`.\n   */\n  private loadFromDirectory(dir: string): void {\n    if (!fs.existsSync(dir)) return;\n\n    const files = fs.readdirSync(dir);\n    for (const file of files) {\n      if (!file.endsWith('.json')) continue;\n      const locale = file.replace(/\\.json$/, '');\n      const filePath = path.join(dir, file);\n      try {\n        const content = fs.readFileSync(filePath, 'utf-8');\n        const data = JSON.parse(content) as Record<string, unknown>;\n        this.translations.set(locale, data);\n      } catch {\n        // Skip files that can't be parsed\n      }\n    }\n  }\n\n  private resolveFromLocale(key: string, locale: string): string | undefined {\n    const data = this.translations.get(locale);\n    if (!data) return undefined;\n    return resolveKey(data, key);\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport type { IHttpServer, IHttpRequest, IHttpResponse } from '@objectstack/spec/contracts';\nimport type { II18nService } from '@objectstack/spec/contracts';\nimport { FileI18nAdapter } from './file-i18n-adapter.js';\nimport type { FileI18nAdapterOptions } from './file-i18n-adapter.js';\n\n/**\n * Configuration options for the I18nServicePlugin.\n */\nexport interface I18nServicePluginOptions {\n  /** Default locale (default: 'en') */\n  defaultLocale?: string;\n  /** Directory containing locale JSON files */\n  localesDir?: string;\n  /** Fallback locale for missing translations */\n  fallbackLocale?: string;\n  /**\n   * Whether to automatically register i18n REST routes with the HTTP server.\n   * When true (default), the plugin registers `/api/v1/i18n/*` endpoints\n   * via the `kernel:ready` hook. When false or no HTTP server is available,\n   * routes are skipped but the i18n service is still available via the kernel.\n   * @default true\n   */\n  registerRoutes?: boolean;\n  /**\n   * Base path for i18n REST routes.\n   * @default '/api/v1/i18n'\n   */\n  basePath?: string;\n}\n\n/**\n * I18nServicePlugin — Production II18nService implementation.\n *\n * Registers an i18n service with the kernel during the init phase,\n * and self-registers REST endpoints (`/api/v1/i18n/*`) with the HTTP\n * server during the `kernel:ready` hook.\n *\n * REST route self-registration follows the same autonomous plugin pattern\n * used by AuthPlugin, WorkflowPlugin, and other service plugins — RestServer\n * is not involved.\n *\n * @example\n * ```ts\n * import { ObjectKernel } from '@objectstack/core';\n * import { I18nServicePlugin } from '@objectstack/service-i18n';\n *\n * const kernel = new ObjectKernel();\n * kernel.use(new I18nServicePlugin({\n *   defaultLocale: 'en',\n *   localesDir: './i18n',\n *   fallbackLocale: 'en',\n * }));\n * await kernel.bootstrap();\n *\n * const i18n = kernel.getService('i18n');\n * i18n.t('objects.account.label', 'en'); // 'Account'\n * ```\n */\nexport class I18nServicePlugin implements Plugin {\n  name = 'com.objectstack.service.i18n';\n  version = '1.0.0';\n  type = 'standard';\n\n  private readonly options: I18nServicePluginOptions;\n  private i18n: II18nService | null = null;\n\n  constructor(options: I18nServicePluginOptions = {}) {\n    this.options = options;\n  }\n\n  async init(ctx: PluginContext): Promise<void> {\n    const adapterOptions: FileI18nAdapterOptions = {\n      defaultLocale: this.options.defaultLocale,\n      localesDir: this.options.localesDir,\n      fallbackLocale: this.options.fallbackLocale,\n    };\n\n    this.i18n = new FileI18nAdapter(adapterOptions);\n    ctx.registerService('i18n', this.i18n);\n    ctx.logger.info(\n      `I18nServicePlugin: registered file-based i18n adapter (default: ${this.i18n.getDefaultLocale?.() ?? 'en'})`,\n    );\n  }\n\n  async start(ctx: PluginContext): Promise<void> {\n    // Defer HTTP route registration to kernel:ready hook.\n    // This ensures all plugins (including HonoServerPlugin) have completed\n    // their init and start phases before we attempt to look up the\n    // http-server service — making I18nServicePlugin resilient to plugin\n    // loading order.\n    if (this.options.registerRoutes !== false) {\n      ctx.hook('kernel:ready', async () => {\n        let httpServer: IHttpServer | null = null;\n        try {\n          httpServer = ctx.getService<IHttpServer>('http-server');\n        } catch {\n          // Service not found — expected in MSW/mock mode\n        }\n\n        if (httpServer) {\n          this.registerI18nRoutes(httpServer, ctx);\n        } else {\n          ctx.logger.warn(\n            'No HTTP server available — i18n routes not registered. ' +\n            'i18n service is still available programmatically via kernel.getService(\"i18n\").'\n          );\n        }\n      });\n    }\n  }\n\n  /**\n   * Register i18n REST routes with the HTTP server.\n   *\n   * Routes:\n   * - GET /api/v1/i18n/locales           → list available locales\n   * - GET /api/v1/i18n/translations/:locale → get translations for a locale\n   * - GET /api/v1/i18n/labels/:object/:locale → get field labels for an object\n   */\n  private registerI18nRoutes(httpServer: IHttpServer, ctx: PluginContext): void {\n    if (!this.i18n) return;\n\n    const basePath = this.options.basePath || '/api/v1/i18n';\n    const i18n = this.i18n;\n\n    // GET /i18n/locales\n    httpServer.get(`${basePath}/locales`, async (_req: IHttpRequest, res: IHttpResponse) => {\n      try {\n        const locales = i18n.getLocales();\n        const defaultLocale = i18n.getDefaultLocale?.() ?? 'en';\n        res.json({\n          data: {\n            locales: locales.map((code) => ({\n              code,\n              label: code,\n              isDefault: code === defaultLocale,\n            })),\n          },\n        });\n      } catch (error: any) {\n        res.status(500).json({ error: error.message });\n      }\n    });\n\n    // GET /i18n/translations/:locale\n    httpServer.get(`${basePath}/translations/:locale`, async (req: IHttpRequest, res: IHttpResponse) => {\n      try {\n        const locale = req.params.locale;\n        if (!locale) {\n          res.status(400).json({ error: 'Missing locale parameter' });\n          return;\n        }\n        const translations = i18n.getTranslations(locale);\n        res.json({ data: { locale, translations } });\n      } catch (error: any) {\n        res.status(500).json({ error: error.message });\n      }\n    });\n\n    // GET /i18n/labels/:object/:locale\n    httpServer.get(`${basePath}/labels/:object/:locale`, async (req: IHttpRequest, res: IHttpResponse) => {\n      try {\n        const objectName = req.params.object;\n        const locale = req.params.locale;\n        if (!objectName || !locale) {\n          res.status(400).json({ error: 'Missing object or locale parameter' });\n          return;\n        }\n        // Some implementations may provide a dedicated getFieldLabels method\n        const hasGetFieldLabels = 'getFieldLabels' in i18n\n          && typeof (i18n as Record<string, unknown>)['getFieldLabels'] === 'function';\n        if (hasGetFieldLabels) {\n          const labels = (i18n as II18nService & { getFieldLabels(obj: string, loc: string): Record<string, string> })\n            .getFieldLabels(objectName, locale);\n          res.json({ data: { object: objectName, locale, labels } });\n        } else {\n          // Fallback: derive field labels from full translation bundle\n          const translations = i18n.getTranslations(locale);\n          const prefix = `o.${objectName}.fields.`;\n          const labels: Record<string, string> = {};\n          for (const [key, value] of Object.entries(translations)) {\n            if (key.startsWith(prefix)) {\n              labels[key.substring(prefix.length)] = value as string;\n            }\n          }\n          res.json({ data: { object: objectName, locale, labels } });\n        }\n      } catch (error: any) {\n        res.status(500).json({ error: error.message });\n      }\n    });\n\n    ctx.logger.info(`I18n routes registered: ${basePath}/locales, ${basePath}/translations/:locale, ${basePath}/labels/:object/:locale`);\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectstack/service-i18n",
-  "version": "3.2.9",
+  "version": "3.3.1",
   "license": "Apache-2.0",
   "description": "I18n Service for ObjectStack — implements II18nService with file-based locale loading",
   "type": "module",
@@ -14,8 +14,8 @@
     }
   },
   "dependencies": {
-    "@objectstack/core": "3.2.9",
-    "@objectstack/spec": "3.2.9"
+    "@objectstack/core": "3.3.1",
+    "@objectstack/spec": "3.3.1"
   },
   "devDependencies": {
     "typescript": "^5.0.0",

package/src/file-i18n-adapter.test.ts

@@ -127,6 +127,42 @@ describe('FileI18nAdapter', () => {
     expect(i18n.t('missing.key', 'zh-CN')).toBe('missing.key');
   });
 
+  it('should deep-merge nested objects from multiple plugins', () => {
+    const i18n = new FileI18nAdapter();
+
+    // Plugin 1: CRM objects
+    i18n.loadTranslations('en', {
+      objects: {
+        account: { label: 'Account', fields: { name: { label: 'Account Name' } } },
+        contact: { label: 'Contact' },
+      },
+      apps: { crm: { label: 'CRM' } },
+    });
+
+    // Plugin 2: HR objects
+    i18n.loadTranslations('en', {
+      objects: {
+        department: { label: 'Department', fields: { name: { label: 'Department Name' } } },
+        employee: { label: 'Employee' },
+      },
+      apps: { hr: { label: 'HR' } },
+    });
+
+    const data = i18n.getTranslations('en');
+
+    // Both plugins' objects must be preserved (not overwritten)
+    expect(i18n.t('objects.account.label', 'en')).toBe('Account');
+    expect(i18n.t('objects.contact.label', 'en')).toBe('Contact');
+    expect(i18n.t('objects.department.label', 'en')).toBe('Department');
+    expect(i18n.t('objects.employee.label', 'en')).toBe('Employee');
+    expect(i18n.t('objects.account.fields.name.label', 'en')).toBe('Account Name');
+    expect(i18n.t('objects.department.fields.name.label', 'en')).toBe('Department Name');
+
+    // Both plugins' apps must be preserved
+    expect((data as any).apps.crm.label).toBe('CRM');
+    expect((data as any).apps.hr.label).toBe('HR');
+  });
+
   describe('file-based loading', () => {
     let tmpDir: string;
 

package/src/file-i18n-adapter.ts

@@ -33,6 +33,34 @@ function resolveKey(data: Record<string, unknown>, key: string): string | undefi
   return typeof current === 'string' ? current : undefined;
 }
 
+/**
+ * Deep-merge two plain objects recursively.
+ * Arrays and non-plain-object values from `source` overwrite those in `target`.
+ */
+function deepMerge(
+  target: Record<string, unknown>,
+  source: Record<string, unknown>,
+): Record<string, unknown> {
+  const result: Record<string, unknown> = { ...target };
+  for (const key of Object.keys(source)) {
+    const tVal = target[key];
+    const sVal = source[key];
+    if (
+      tVal && sVal
+      && typeof tVal === 'object' && !Array.isArray(tVal)
+      && typeof sVal === 'object' && !Array.isArray(sVal)
+    ) {
+      result[key] = deepMerge(
+        tVal as Record<string, unknown>,
+        sVal as Record<string, unknown>,
+      );
+    } else {
+      result[key] = sVal;
+    }
+  }
+  return result;
+}
+
 /**
  * Interpolate parameters into a translated string.
  * Replaces `{{paramName}}` with the corresponding value from params.
@@ -115,8 +143,9 @@ export class FileI18nAdapter implements II18nService {
   loadTranslations(locale: string, translations: Record<string, unknown>): void {
     const existing = this.translations.get(locale);
     if (existing) {
-      // Merge into existing translations
-      this.translations.set(locale, { ...existing, ...translations });
+      // Deep-merge so multiple plugins can contribute to the same nested keys
+      // (e.g. each plugin adds its own objects under `objects.*`)
+      this.translations.set(locale, deepMerge(existing, translations));
     } else {
       this.translations.set(locale, { ...translations });
     }