@objectstack/service-i18n 4.0.4 → 4.1.0

package/README.md

@@ -258,18 +258,16 @@ await i18n.reload();
 Translate metadata labels automatically:
 
 ```typescript
-import { defineObject } from '@objectstack/spec';
+import { ObjectSchema, Field } from '@objectstack/spec/data';
 
-const contact = defineObject({
+const contact = ObjectSchema.create({
   name: 'contact',
   label: 'i18n:objects.contact.label', // References translation key
-  fields: [
-    {
-      name: 'name',
+  fields: {
+    name: Field.text({
       label: 'i18n:fields.contact.name',
-      type: 'text',
-    },
-  ],
+    }),
+  },
 });
 
 // Translation file: locales/en-US/metadata.json

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectstack/service-i18n",
-  "version": "4.0.4",
+  "version": "4.1.0",
   "license": "Apache-2.0",
   "description": "I18n Service for ObjectStack — implements II18nService with file-based locale loading",
   "type": "module",
@@ -14,13 +14,38 @@
     }
   },
   "dependencies": {
-    "@objectstack/core": "4.0.4",
-    "@objectstack/spec": "4.0.4"
+    "@objectstack/core": "4.1.0",
+    "@objectstack/spec": "4.1.0"
   },
   "devDependencies": {
-    "@types/node": "^25.6.0",
-    "typescript": "^6.0.2",
-    "vitest": "^4.1.4"
+    "@types/node": "^25.9.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.7"
+  },
+  "keywords": [
+    "objectstack",
+    "service",
+    "i18n",
+    "l10n",
+    "translations"
+  ],
+  "author": "ObjectStack",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/objectstack-ai/framework.git",
+    "directory": "packages/services/service-i18n"
+  },
+  "homepage": "https://objectstack.ai/docs",
+  "bugs": "https://github.com/objectstack-ai/framework/issues",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
   },
   "scripts": {
     "build": "tsup --config ../../../tsup.config.ts",

package/.turbo/turbo-build.log

@@ -1,22 +0,0 @@
-
-> @objectstack/service-i18n@4.0.4 build /home/runner/work/framework/framework/packages/services/service-i18n
-> tsup --config ../../../tsup.config.ts
-
-CLI Building entry: src/index.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.5.1
-CLI Using tsup config: /home/runner/work/framework/framework/tsup.config.ts
-CLI Target: es2020
-CLI Cleaning output folder
-ESM Build start
-CJS Build start
-CJS dist/index.cjs     8.50 KB
-CJS dist/index.cjs.map 18.42 KB
-CJS ⚡️ Build success in 123ms
-ESM dist/index.js     6.84 KB
-ESM dist/index.js.map 18.02 KB
-ESM ⚡️ Build success in 130ms
-DTS Build start
-DTS ⚡️ Build success in 16111ms
-DTS dist/index.d.ts  4.41 KB
-DTS dist/index.d.cts 4.41 KB

package/CHANGELOG.md

@@ -1,170 +0,0 @@
-# @objectstack/service-i18n
-
-## 4.0.4
-
-### Patch Changes
-
-- Updated dependencies [326b66b]
-  - @objectstack/spec@4.0.4
-  - @objectstack/core@4.0.4
-
-## 4.0.3
-
-### Patch Changes
-
-- @objectstack/spec@4.0.3
-- @objectstack/core@4.0.3
-
-## 4.0.2
-
-### Patch Changes
-
-- Updated dependencies [5f659e9]
-  - @objectstack/spec@4.0.2
-  - @objectstack/core@4.0.2
-
-## 4.0.0
-
-### Patch Changes
-
-- Updated dependencies [f08ffc3]
-- Updated dependencies [e0b0a78]
-  - @objectstack/spec@4.0.0
-  - @objectstack/core@4.0.0
-
-## 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
-
-- @objectstack/spec@3.2.9
-- @objectstack/core@3.2.9
-
-## 3.2.8
-
-### Patch Changes
-
-- @objectstack/spec@3.2.8
-- @objectstack/core@3.2.8
-
-## 3.2.7
-
-### Patch Changes
-
-- @objectstack/spec@3.2.7
-- @objectstack/core@3.2.7
-
-## 3.2.6
-
-### Patch Changes
-
-- 83151bc: fix i18n
-  - @objectstack/spec@3.2.6
-  - @objectstack/core@3.2.6
-
-## 3.2.5
-
-### Patch Changes
-
-- @objectstack/spec@3.2.5
-- @objectstack/core@3.2.5
-
-## 3.2.4
-
-### Patch Changes
-
-- @objectstack/spec@3.2.4
-- @objectstack/core@3.2.4
-
-## 3.2.3
-
-### Patch Changes
-
-- @objectstack/spec@3.2.3
-- @objectstack/core@3.2.3
-
-## 3.2.2
-
-### Patch Changes
-
-- Updated dependencies [46defbb]
-  - @objectstack/spec@3.2.2
-  - @objectstack/core@3.2.2
-
-## 3.2.1
-
-### Patch Changes
-
-- Updated dependencies [850b546]
-  - @objectstack/spec@3.2.1
-  - @objectstack/core@3.2.1
-
-## 3.2.0
-
-### Patch Changes
-
-- Updated dependencies [5901c29]
-  - @objectstack/spec@3.2.0
-  - @objectstack/core@3.2.0
-
-## 3.1.1
-
-### Patch Changes
-
-- Updated dependencies [953d667]
-  - @objectstack/spec@3.1.1
-  - @objectstack/core@3.1.1
-
-## 3.1.0
-
-### Patch Changes
-
-- Updated dependencies [0088830]
-  - @objectstack/spec@3.1.0
-  - @objectstack/core@3.1.0
-
-## 3.0.11
-
-### Patch Changes
-
-- Updated dependencies [92d9d99]
-  - @objectstack/spec@3.0.11
-  - @objectstack/core@3.0.11
-
-## 3.0.10
-
-### Patch Changes
-
-- Updated dependencies [d1e5d31]
-  - @objectstack/spec@3.0.10
-  - @objectstack/core@3.0.10
-
-## 3.0.9
-
-### Patch Changes
-
-- Updated dependencies [15e0df6]
-  - @objectstack/spec@3.0.9
-  - @objectstack/core@3.0.9
-
-## 3.0.8
-
-### Patch Changes
-
-- Updated dependencies [5a968a2]
-  - @objectstack/spec@3.0.8
-  - @objectstack/core@3.0.8

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

@@ -1,221 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import { describe, it, expect, beforeEach, afterEach } from 'vitest';
-import { FileI18nAdapter } from './file-i18n-adapter';
-import type { II18nService } from '@objectstack/spec/contracts';
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import * as os from 'node:os';
-
-describe('FileI18nAdapter', () => {
-  it('should implement II18nService contract', () => {
-    const i18n: II18nService = new FileI18nAdapter();
-    expect(typeof i18n.t).toBe('function');
-    expect(typeof i18n.getTranslations).toBe('function');
-    expect(typeof i18n.loadTranslations).toBe('function');
-    expect(typeof i18n.getLocales).toBe('function');
-    expect(typeof i18n.getDefaultLocale).toBe('function');
-    expect(typeof i18n.setDefaultLocale).toBe('function');
-  });
-
-  it('should default to "en" locale', () => {
-    const i18n = new FileI18nAdapter();
-    expect(i18n.getDefaultLocale()).toBe('en');
-  });
-
-  it('should use custom default locale', () => {
-    const i18n = new FileI18nAdapter({ defaultLocale: 'zh-CN' });
-    expect(i18n.getDefaultLocale()).toBe('zh-CN');
-  });
-
-  it('should set and get default locale', () => {
-    const i18n = new FileI18nAdapter();
-    i18n.setDefaultLocale('ja');
-    expect(i18n.getDefaultLocale()).toBe('ja');
-  });
-
-  it('should return empty translations for unknown locale', () => {
-    const i18n = new FileI18nAdapter();
-    expect(i18n.getTranslations('fr')).toEqual({});
-  });
-
-  it('should return empty locales when no translations loaded', () => {
-    const i18n = new FileI18nAdapter();
-    expect(i18n.getLocales()).toEqual([]);
-  });
-
-  it('should load and retrieve translations', () => {
-    const i18n = new FileI18nAdapter();
-    i18n.loadTranslations('en', { greeting: 'Hello' });
-    i18n.loadTranslations('zh-CN', { greeting: '你好' });
-
-    expect(i18n.getLocales()).toContain('en');
-    expect(i18n.getLocales()).toContain('zh-CN');
-    expect(i18n.getTranslations('en')).toEqual({ greeting: 'Hello' });
-    expect(i18n.getTranslations('zh-CN')).toEqual({ greeting: '你好' });
-  });
-
-  it('should merge translations when loading into existing locale', () => {
-    const i18n = new FileI18nAdapter();
-    i18n.loadTranslations('en', { greeting: 'Hello' });
-    i18n.loadTranslations('en', { farewell: 'Goodbye' });
-
-    expect(i18n.getTranslations('en')).toEqual({
-      greeting: 'Hello',
-      farewell: 'Goodbye',
-    });
-  });
-
-  it('should translate a simple key', () => {
-    const i18n = new FileI18nAdapter();
-    i18n.loadTranslations('en', { greeting: 'Hello' });
-
-    expect(i18n.t('greeting', 'en')).toBe('Hello');
-  });
-
-  it('should return key when translation is missing', () => {
-    const i18n = new FileI18nAdapter();
-    expect(i18n.t('missing.key', 'en')).toBe('missing.key');
-  });
-
-  it('should resolve nested dot-notation keys', () => {
-    const i18n = new FileI18nAdapter();
-    i18n.loadTranslations('en', {
-      objects: {
-        account: {
-          label: 'Account',
-        },
-      },
-    });
-
-    expect(i18n.t('objects.account.label', 'en')).toBe('Account');
-  });
-
-  it('should interpolate parameters', () => {
-    const i18n = new FileI18nAdapter();
-    i18n.loadTranslations('en', { greeting: 'Hello, {{name}}!' });
-
-    expect(i18n.t('greeting', 'en', { name: 'World' })).toBe('Hello, World!');
-  });
-
-  it('should keep placeholder when parameter is missing', () => {
-    const i18n = new FileI18nAdapter();
-    i18n.loadTranslations('en', { greeting: 'Hello, {{name}}!' });
-
-    expect(i18n.t('greeting', 'en', {})).toBe('Hello, {{name}}!');
-  });
-
-  it('should fallback to fallback locale when key not found', () => {
-    const i18n = new FileI18nAdapter({ fallbackLocale: 'en' });
-    i18n.loadTranslations('en', { greeting: 'Hello' });
-
-    expect(i18n.t('greeting', 'zh-CN')).toBe('Hello');
-  });
-
-  it('should not fallback when key exists in requested locale', () => {
-    const i18n = new FileI18nAdapter({ fallbackLocale: 'en' });
-    i18n.loadTranslations('en', { greeting: 'Hello' });
-    i18n.loadTranslations('zh-CN', { greeting: '你好' });
-
-    expect(i18n.t('greeting', 'zh-CN')).toBe('你好');
-  });
-
-  it('should return key when neither locale nor fallback has translation', () => {
-    const i18n = new FileI18nAdapter({ fallbackLocale: 'en' });
-    i18n.loadTranslations('en', { greeting: 'Hello' });
-
-    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;
-
-    beforeEach(() => {
-      tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'i18n-test-'));
-    });
-
-    afterEach(() => {
-      fs.rmSync(tmpDir, { recursive: true, force: true });
-    });
-
-    it('should load translations from JSON files in a directory', () => {
-      fs.writeFileSync(
-        path.join(tmpDir, 'en.json'),
-        JSON.stringify({ greeting: 'Hello', objects: { account: { label: 'Account' } } }),
-      );
-      fs.writeFileSync(
-        path.join(tmpDir, 'zh-CN.json'),
-        JSON.stringify({ greeting: '你好', objects: { account: { label: '客户' } } }),
-      );
-
-      const i18n = new FileI18nAdapter({ localesDir: tmpDir });
-
-      expect(i18n.getLocales()).toContain('en');
-      expect(i18n.getLocales()).toContain('zh-CN');
-      expect(i18n.t('greeting', 'en')).toBe('Hello');
-      expect(i18n.t('greeting', 'zh-CN')).toBe('你好');
-      expect(i18n.t('objects.account.label', 'en')).toBe('Account');
-      expect(i18n.t('objects.account.label', 'zh-CN')).toBe('客户');
-    });
-
-    it('should ignore non-JSON files in the directory', () => {
-      fs.writeFileSync(path.join(tmpDir, 'en.json'), JSON.stringify({ greeting: 'Hello' }));
-      fs.writeFileSync(path.join(tmpDir, 'notes.txt'), 'not a translation file');
-
-      const i18n = new FileI18nAdapter({ localesDir: tmpDir });
-
-      expect(i18n.getLocales()).toEqual(['en']);
-    });
-
-    it('should skip malformed JSON files gracefully', () => {
-      fs.writeFileSync(path.join(tmpDir, 'en.json'), JSON.stringify({ greeting: 'Hello' }));
-      fs.writeFileSync(path.join(tmpDir, 'bad.json'), '{invalid json');
-
-      const i18n = new FileI18nAdapter({ localesDir: tmpDir });
-
-      expect(i18n.getLocales()).toEqual(['en']);
-      expect(i18n.t('greeting', 'en')).toBe('Hello');
-    });
-
-    it('should handle non-existent directory gracefully', () => {
-      const i18n = new FileI18nAdapter({ localesDir: '/nonexistent/path' });
-      expect(i18n.getLocales()).toEqual([]);
-    });
-  });
-});

package/src/file-i18n-adapter.ts

@@ -1,193 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import type { II18nService } from '@objectstack/spec/contracts';
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-
-/**
- * Configuration options for FileI18nAdapter.
- */
-export interface FileI18nAdapterOptions {
-  /** Default locale (e.g. 'en') */
-  defaultLocale?: string;
-  /** Directory containing locale files (JSON). Each file should be named `{locale}.json`. */
-  localesDir?: string;
-  /** Fallback locale when a key is not found in the requested locale */
-  fallbackLocale?: string;
-}
-
-/**
- * Resolve a nested key in a translations object using dot notation.
- *
- * @param data - Translation data object
- * @param key - Dot-separated key (e.g. 'objects.account.label')
- * @returns The resolved string value, or undefined if not found
- */
-function resolveKey(data: Record<string, unknown>, key: string): string | undefined {
-  const parts = key.split('.');
-  let current: unknown = data;
-  for (const part of parts) {
-    if (current == null || typeof current !== 'object') return undefined;
-    current = (current as Record<string, unknown>)[part];
-  }
-  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.
- *
- * @param template - Template string with `{{key}}` placeholders
- * @param params - Parameter map
- * @returns Interpolated string
- */
-function interpolate(template: string, params: Record<string, unknown>): string {
-  return template.replace(/\{\{(\w+)\}\}/g, (_match, key: string) => {
-    return params[key] != null ? String(params[key]) : `{{${key}}}`;
-  });
-}
-
-/**
- * File-based I18n adapter implementing II18nService.
- *
- * Loads JSON translation files from a directory on disk.
- * Each file should be named `{locale}.json` and contain a flat or nested
- * key-value map of translations.
- *
- * Supports:
- * - Dot-notation key resolution (e.g. 'objects.account.label')
- * - Parameter interpolation via `{{paramName}}` syntax
- * - Fallback locale for missing translations
- * - Runtime translation loading via loadTranslations()
- *
- * Suitable for server-side rendering, CLI tools, and development environments.
- *
- * @example
- * ```ts
- * const i18n = new FileI18nAdapter({
- *   defaultLocale: 'en',
- *   localesDir: './i18n',
- *   fallbackLocale: 'en',
- * });
- *
- * i18n.t('objects.account.label', 'zh-CN'); // '客户'
- * i18n.t('greeting', 'en', { name: 'World' }); // 'Hello, World!'
- * ```
- */
-export class FileI18nAdapter implements II18nService {
-  private readonly translations = new Map<string, Record<string, unknown>>();
-  private defaultLocale: string;
-  private readonly fallbackLocale: string | undefined;
-
-  constructor(options: FileI18nAdapterOptions = {}) {
-    this.defaultLocale = options.defaultLocale ?? 'en';
-    this.fallbackLocale = options.fallbackLocale;
-
-    if (options.localesDir) {
-      this.loadFromDirectory(options.localesDir);
-    }
-  }
-
-  t(key: string, locale: string, params?: Record<string, unknown>): string {
-    // Try requested locale
-    let value = this.resolveFromLocale(key, locale);
-
-    // Try fallback locale
-    if (value === undefined && this.fallbackLocale && this.fallbackLocale !== locale) {
-      value = this.resolveFromLocale(key, this.fallbackLocale);
-    }
-
-    // Return key if not found
-    if (value === undefined) return key;
-
-    // Interpolate parameters
-    if (params && Object.keys(params).length > 0) {
-      return interpolate(value, params);
-    }
-
-    return value;
-  }
-
-  getTranslations(locale: string): Record<string, unknown> {
-    return this.translations.get(locale) ?? {};
-  }
-
-  loadTranslations(locale: string, translations: Record<string, unknown>): void {
-    const existing = this.translations.get(locale);
-    if (existing) {
-      // 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 });
-    }
-  }
-
-  getLocales(): string[] {
-    return Array.from(this.translations.keys());
-  }
-
-  getDefaultLocale(): string {
-    return this.defaultLocale;
-  }
-
-  setDefaultLocale(locale: string): void {
-    this.defaultLocale = locale;
-  }
-
-  /**
-   * Load all JSON translation files from a directory.
-   * Each file should be named `{locale}.json`.
-   */
-  private loadFromDirectory(dir: string): void {
-    if (!fs.existsSync(dir)) return;
-
-    const files = fs.readdirSync(dir);
-    for (const file of files) {
-      if (!file.endsWith('.json')) continue;
-      const locale = file.replace(/\.json$/, '');
-      const filePath = path.join(dir, file);
-      try {
-        const content = fs.readFileSync(filePath, 'utf-8');
-        const data = JSON.parse(content) as Record<string, unknown>;
-        this.translations.set(locale, data);
-      } catch {
-        // Skip files that can't be parsed
-      }
-    }
-  }
-
-  private resolveFromLocale(key: string, locale: string): string | undefined {
-    const data = this.translations.get(locale);
-    if (!data) return undefined;
-    return resolveKey(data, key);
-  }
-}

package/src/i18n-service-plugin.test.ts

@@ -1,280 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-import { I18nServicePlugin } from './i18n-service-plugin';
-import type { IHttpRequest, IHttpResponse, RouteHandler } from '@objectstack/spec/contracts';
-
-// ---------------------------------------------------------------------------
-// Mocks
-// ---------------------------------------------------------------------------
-
-function createMockHttpServer() {
-  const routes = new Map<string, RouteHandler>();
-  return {
-    get: vi.fn((path: string, handler: RouteHandler) => { routes.set(`GET:${path}`, handler); }),
-    post: vi.fn(),
-    put: vi.fn(),
-    delete: vi.fn(),
-    patch: vi.fn(),
-    use: vi.fn(),
-    listen: vi.fn().mockResolvedValue(undefined),
-    close: vi.fn().mockResolvedValue(undefined),
-    /** Test helper: retrieve a registered handler */
-    _getHandler(method: string, path: string): RouteHandler | undefined {
-      return routes.get(`${method}:${path}`);
-    },
-  };
-}
-
-function createMockPluginContext(services: Record<string, any> = {}) {
-  const hooks = new Map<string, Array<(...args: any[]) => Promise<void>>>();
-  return {
-    registerService: vi.fn(),
-    getService: vi.fn((name: string) => {
-      if (services[name]) return services[name];
-      throw new Error(`Service '${name}' not found`);
-    }),
-    getServices: vi.fn(() => new Map(Object.entries(services))),
-    hook: vi.fn((name: string, handler: (...args: any[]) => Promise<void>) => {
-      if (!hooks.has(name)) hooks.set(name, []);
-      hooks.get(name)!.push(handler);
-    }),
-    trigger: vi.fn(async (name: string, ...args: any[]) => {
-      const handlers = hooks.get(name) ?? [];
-      for (const h of handlers) await h(...args);
-    }),
-    logger: {
-      info: vi.fn(),
-      warn: vi.fn(),
-      error: vi.fn(),
-      debug: vi.fn(),
-    },
-    getKernel: vi.fn(),
-    replaceService: vi.fn(),
-  };
-}
-
-function createMockReq(overrides: Partial<IHttpRequest> = {}): IHttpRequest {
-  return {
-    params: {},
-    query: {},
-    headers: {},
-    method: 'GET',
-    path: '/',
-    ...overrides,
-  };
-}
-
-function createMockRes(): IHttpResponse & { _data: any; _status: number } {
-  const res: any = {
-    _data: null,
-    _status: 200,
-    json(data: any) { res._data = data; },
-    send(data: string) { res._data = data; },
-    status(code: number) { res._status = code; return res; },
-    header() { return res; },
-  };
-  return res;
-}
-
-// ---------------------------------------------------------------------------
-// Tests
-// ---------------------------------------------------------------------------
-
-describe('I18nServicePlugin', () => {
-  let httpServer: ReturnType<typeof createMockHttpServer>;
-  let ctx: ReturnType<typeof createMockPluginContext>;
-
-  beforeEach(() => {
-    httpServer = createMockHttpServer();
-    ctx = createMockPluginContext({ 'http-server': httpServer });
-  });
-
-  // -- Service registration -------------------------------------------------
-
-  describe('init', () => {
-    it('should register i18n service during init', async () => {
-      const plugin = new I18nServicePlugin();
-      await plugin.init!(ctx as any);
-
-      expect(ctx.registerService).toHaveBeenCalledWith('i18n', expect.any(Object));
-    });
-
-    it('should pass options to the FileI18nAdapter', async () => {
-      const plugin = new I18nServicePlugin({ defaultLocale: 'zh-CN' });
-      await plugin.init!(ctx as any);
-
-      const registeredService = ctx.registerService.mock.calls[0][1];
-      expect(registeredService.getDefaultLocale()).toBe('zh-CN');
-    });
-  });
-
-  // -- Route self-registration ----------------------------------------------
-
-  describe('route self-registration', () => {
-    it('should register a kernel:ready hook during start', async () => {
-      const plugin = new I18nServicePlugin();
-      await plugin.init!(ctx as any);
-      await plugin.start!(ctx as any);
-
-      expect(ctx.hook).toHaveBeenCalledWith('kernel:ready', expect.any(Function));
-    });
-
-    it('should register i18n routes when http-server is available', async () => {
-      const plugin = new I18nServicePlugin();
-      await plugin.init!(ctx as any);
-      await plugin.start!(ctx as any);
-
-      // Simulate kernel:ready
-      await ctx.trigger('kernel:ready');
-
-      expect(httpServer.get).toHaveBeenCalledWith('/api/v1/i18n/locales', expect.any(Function));
-      expect(httpServer.get).toHaveBeenCalledWith('/api/v1/i18n/translations/:locale', expect.any(Function));
-      expect(httpServer.get).toHaveBeenCalledWith('/api/v1/i18n/labels/:object/:locale', expect.any(Function));
-    });
-
-    it('should respect custom basePath', async () => {
-      const plugin = new I18nServicePlugin({ basePath: '/custom/i18n' });
-      await plugin.init!(ctx as any);
-      await plugin.start!(ctx as any);
-
-      await ctx.trigger('kernel:ready');
-
-      expect(httpServer.get).toHaveBeenCalledWith('/custom/i18n/locales', expect.any(Function));
-      expect(httpServer.get).toHaveBeenCalledWith('/custom/i18n/translations/:locale', expect.any(Function));
-      expect(httpServer.get).toHaveBeenCalledWith('/custom/i18n/labels/:object/:locale', expect.any(Function));
-    });
-
-    it('should skip route registration when registerRoutes is false', async () => {
-      const plugin = new I18nServicePlugin({ registerRoutes: false });
-      await plugin.init!(ctx as any);
-      await plugin.start!(ctx as any);
-
-      expect(ctx.hook).not.toHaveBeenCalled();
-    });
-
-    it('should gracefully skip routes when http-server is not available', async () => {
-      const ctxNoHttp = createMockPluginContext({}); // no http-server
-      const plugin = new I18nServicePlugin();
-      await plugin.init!(ctxNoHttp as any);
-      await plugin.start!(ctxNoHttp as any);
-
-      await ctxNoHttp.trigger('kernel:ready');
-
-      expect(ctxNoHttp.logger.warn).toHaveBeenCalledWith(
-        expect.stringContaining('No HTTP server available'),
-      );
-    });
-  });
-
-  // -- Route handler behavior -----------------------------------------------
-
-  describe('route handlers', () => {
-    async function setupPlugin(options: ConstructorParameters<typeof I18nServicePlugin>[0] = {}) {
-      const plugin = new I18nServicePlugin(options);
-      await plugin.init!(ctx as any);
-      // Load some translations after init so the service has data
-      const i18n = ctx.registerService.mock.calls[0][1];
-      i18n.loadTranslations('en', { greeting: 'Hello', 'o.account.fields.name': 'Account Name' });
-      i18n.loadTranslations('zh-CN', { greeting: '你好', 'o.account.fields.name': '账户名称' });
-      await plugin.start!(ctx as any);
-      await ctx.trigger('kernel:ready');
-      return { plugin, i18n };
-    }
-
-    it('GET /locales should return all available locales', async () => {
-      await setupPlugin();
-
-      const handler = httpServer._getHandler('GET', '/api/v1/i18n/locales')!;
-      expect(handler).toBeDefined();
-
-      const req = createMockReq();
-      const res = createMockRes();
-      await handler(req, res);
-
-      expect(res._data).toEqual({
-        data: {
-          locales: [
-            { code: 'en', label: 'en', isDefault: true },
-            { code: 'zh-CN', label: 'zh-CN', isDefault: false },
-          ],
-        },
-      });
-    });
-
-    it('GET /translations/:locale should return translations for the given locale', async () => {
-      await setupPlugin();
-
-      const handler = httpServer._getHandler('GET', '/api/v1/i18n/translations/:locale')!;
-      expect(handler).toBeDefined();
-
-      const req = createMockReq({ params: { locale: 'en' } });
-      const res = createMockRes();
-      await handler(req, res);
-
-      expect(res._data).toEqual({
-        data: {
-          locale: 'en',
-          translations: { greeting: 'Hello', 'o.account.fields.name': 'Account Name' },
-        },
-      });
-    });
-
-    it('GET /translations/:locale should return 400 when locale is missing', async () => {
-      await setupPlugin();
-
-      const handler = httpServer._getHandler('GET', '/api/v1/i18n/translations/:locale')!;
-      const req = createMockReq({ params: {} });
-      const res = createMockRes();
-      await handler(req, res);
-
-      expect(res._status).toBe(400);
-      expect(res._data).toEqual({ error: 'Missing locale parameter' });
-    });
-
-    it('GET /labels/:object/:locale should derive field labels from translation bundle', async () => {
-      await setupPlugin();
-
-      const handler = httpServer._getHandler('GET', '/api/v1/i18n/labels/:object/:locale')!;
-      expect(handler).toBeDefined();
-
-      const req = createMockReq({ params: { object: 'account', locale: 'en' } });
-      const res = createMockRes();
-      await handler(req, res);
-
-      expect(res._data).toEqual({
-        data: {
-          object: 'account',
-          locale: 'en',
-          labels: { name: 'Account Name' },
-        },
-      });
-    });
-
-    it('GET /labels/:object/:locale should return 400 when params are missing', async () => {
-      await setupPlugin();
-
-      const handler = httpServer._getHandler('GET', '/api/v1/i18n/labels/:object/:locale')!;
-      const req = createMockReq({ params: {} });
-      const res = createMockRes();
-      await handler(req, res);
-
-      expect(res._status).toBe(400);
-      expect(res._data).toEqual({ error: 'Missing object or locale parameter' });
-    });
-  });
-
-  // -- Plugin metadata -------------------------------------------------------
-
-  describe('plugin metadata', () => {
-    it('should have correct plugin name', () => {
-      const plugin = new I18nServicePlugin();
-      expect(plugin.name).toBe('com.objectstack.service.i18n');
-    });
-
-    it('should have version', () => {
-      const plugin = new I18nServicePlugin();
-      expect(plugin.version).toBe('1.0.0');
-    });
-  });
-});

package/src/i18n-service-plugin.ts

@@ -1,198 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import type { Plugin, PluginContext } from '@objectstack/core';
-import type { IHttpServer, IHttpRequest, IHttpResponse } from '@objectstack/spec/contracts';
-import type { II18nService } from '@objectstack/spec/contracts';
-import { FileI18nAdapter } from './file-i18n-adapter.js';
-import type { FileI18nAdapterOptions } from './file-i18n-adapter.js';
-
-/**
- * Configuration options for the I18nServicePlugin.
- */
-export interface I18nServicePluginOptions {
-  /** Default locale (default: 'en') */
-  defaultLocale?: string;
-  /** Directory containing locale JSON files */
-  localesDir?: string;
-  /** Fallback locale for missing translations */
-  fallbackLocale?: string;
-  /**
-   * Whether to automatically register i18n REST routes with the HTTP server.
-   * When true (default), the plugin registers `/api/v1/i18n/*` endpoints
-   * via the `kernel:ready` hook. When false or no HTTP server is available,
-   * routes are skipped but the i18n service is still available via the kernel.
-   * @default true
-   */
-  registerRoutes?: boolean;
-  /**
-   * Base path for i18n REST routes.
-   * @default '/api/v1/i18n'
-   */
-  basePath?: string;
-}
-
-/**
- * I18nServicePlugin — Production II18nService implementation.
- *
- * Registers an i18n service with the kernel during the init phase,
- * and self-registers REST endpoints (`/api/v1/i18n/*`) with the HTTP
- * server during the `kernel:ready` hook.
- *
- * REST route self-registration follows the same autonomous plugin pattern
- * used by AuthPlugin, WorkflowPlugin, and other service plugins — RestServer
- * is not involved.
- *
- * @example
- * ```ts
- * import { ObjectKernel } from '@objectstack/core';
- * import { I18nServicePlugin } from '@objectstack/service-i18n';
- *
- * const kernel = new ObjectKernel();
- * kernel.use(new I18nServicePlugin({
- *   defaultLocale: 'en',
- *   localesDir: './i18n',
- *   fallbackLocale: 'en',
- * }));
- * await kernel.bootstrap();
- *
- * const i18n = kernel.getService('i18n');
- * i18n.t('objects.account.label', 'en'); // 'Account'
- * ```
- */
-export class I18nServicePlugin implements Plugin {
-  name = 'com.objectstack.service.i18n';
-  version = '1.0.0';
-  type = 'standard';
-
-  private readonly options: I18nServicePluginOptions;
-  private i18n: II18nService | null = null;
-
-  constructor(options: I18nServicePluginOptions = {}) {
-    this.options = options;
-  }
-
-  async init(ctx: PluginContext): Promise<void> {
-    const adapterOptions: FileI18nAdapterOptions = {
-      defaultLocale: this.options.defaultLocale,
-      localesDir: this.options.localesDir,
-      fallbackLocale: this.options.fallbackLocale,
-    };
-
-    this.i18n = new FileI18nAdapter(adapterOptions);
-    ctx.registerService('i18n', this.i18n);
-    ctx.logger.info(
-      `I18nServicePlugin: registered file-based i18n adapter (default: ${this.i18n.getDefaultLocale?.() ?? 'en'})`,
-    );
-  }
-
-  async start(ctx: PluginContext): Promise<void> {
-    // Defer HTTP route registration to kernel:ready hook.
-    // This ensures all plugins (including HonoServerPlugin) have completed
-    // their init and start phases before we attempt to look up the
-    // http-server service — making I18nServicePlugin resilient to plugin
-    // loading order.
-    if (this.options.registerRoutes !== false) {
-      ctx.hook('kernel:ready', async () => {
-        let httpServer: IHttpServer | null = null;
-        try {
-          httpServer = ctx.getService<IHttpServer>('http-server');
-        } catch {
-          // Service not found — expected in MSW/mock mode
-        }
-
-        if (httpServer) {
-          this.registerI18nRoutes(httpServer, ctx);
-        } else {
-          ctx.logger.warn(
-            'No HTTP server available — i18n routes not registered. ' +
-            'i18n service is still available programmatically via kernel.getService("i18n").'
-          );
-        }
-      });
-    }
-  }
-
-  /**
-   * Register i18n REST routes with the HTTP server.
-   *
-   * Routes:
-   * - GET /api/v1/i18n/locales           → list available locales
-   * - GET /api/v1/i18n/translations/:locale → get translations for a locale
-   * - GET /api/v1/i18n/labels/:object/:locale → get field labels for an object
-   */
-  private registerI18nRoutes(httpServer: IHttpServer, ctx: PluginContext): void {
-    if (!this.i18n) return;
-
-    const basePath = this.options.basePath || '/api/v1/i18n';
-    const i18n = this.i18n;
-
-    // GET /i18n/locales
-    httpServer.get(`${basePath}/locales`, async (_req: IHttpRequest, res: IHttpResponse) => {
-      try {
-        const locales = i18n.getLocales();
-        const defaultLocale = i18n.getDefaultLocale?.() ?? 'en';
-        res.json({
-          data: {
-            locales: locales.map((code) => ({
-              code,
-              label: code,
-              isDefault: code === defaultLocale,
-            })),
-          },
-        });
-      } catch (error: any) {
-        res.status(500).json({ error: error.message });
-      }
-    });
-
-    // GET /i18n/translations/:locale
-    httpServer.get(`${basePath}/translations/:locale`, async (req: IHttpRequest, res: IHttpResponse) => {
-      try {
-        const locale = req.params.locale;
-        if (!locale) {
-          res.status(400).json({ error: 'Missing locale parameter' });
-          return;
-        }
-        const translations = i18n.getTranslations(locale);
-        res.json({ data: { locale, translations } });
-      } catch (error: any) {
-        res.status(500).json({ error: error.message });
-      }
-    });
-
-    // GET /i18n/labels/:object/:locale
-    httpServer.get(`${basePath}/labels/:object/:locale`, async (req: IHttpRequest, res: IHttpResponse) => {
-      try {
-        const objectName = req.params.object;
-        const locale = req.params.locale;
-        if (!objectName || !locale) {
-          res.status(400).json({ error: 'Missing object or locale parameter' });
-          return;
-        }
-        // Some implementations may provide a dedicated getFieldLabels method
-        const hasGetFieldLabels = 'getFieldLabels' in i18n
-          && typeof (i18n as Record<string, unknown>)['getFieldLabels'] === 'function';
-        if (hasGetFieldLabels) {
-          const labels = (i18n as II18nService & { getFieldLabels(obj: string, loc: string): Record<string, string> })
-            .getFieldLabels(objectName, locale);
-          res.json({ data: { object: objectName, locale, labels } });
-        } else {
-          // Fallback: derive field labels from full translation bundle
-          const translations = i18n.getTranslations(locale);
-          const prefix = `o.${objectName}.fields.`;
-          const labels: Record<string, string> = {};
-          for (const [key, value] of Object.entries(translations)) {
-            if (key.startsWith(prefix)) {
-              labels[key.substring(prefix.length)] = value as string;
-            }
-          }
-          res.json({ data: { object: objectName, locale, labels } });
-        }
-      } catch (error: any) {
-        res.status(500).json({ error: error.message });
-      }
-    });
-
-    ctx.logger.info(`I18n routes registered: ${basePath}/locales, ${basePath}/translations/:locale, ${basePath}/labels/:object/:locale`);
-  }
-}

package/src/index.ts

@@ -1,6 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-export { I18nServicePlugin } from './i18n-service-plugin.js';
-export type { I18nServicePluginOptions } from './i18n-service-plugin.js';
-export { FileI18nAdapter } from './file-i18n-adapter.js';
-export type { FileI18nAdapterOptions } from './file-i18n-adapter.js';

package/tsconfig.json

@@ -1,17 +0,0 @@
-{
-  "extends": "../../../tsconfig.json",
-  "compilerOptions": {
-    "outDir": "dist",
-    "rootDir": "src",
-    "types": [
-      "node"
-    ]
-  },
-  "include": [
-    "src"
-  ],
-  "exclude": [
-    "node_modules",
-    "dist"
-  ]
-}