@flusys/nestjs-localization 7.1.0 → 8.0.0

package/cjs/controllers/translation.controller.js

@@ -1,195 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "TranslationController", {
-    enumerable: true,
-    get: function() {
-        return TranslationController;
-    }
-});
-const _classes = require("@flusys/nestjs-shared/classes");
-const _decorators = require("@flusys/nestjs-shared/decorators");
-const _guards = require("@flusys/nestjs-shared/guards");
-const _interfaces = require("@flusys/nestjs-shared/interfaces");
-const _common = require("@nestjs/common");
-const _swagger = require("@nestjs/swagger");
-const _config = require("../config");
-const _dtos = require("../dtos");
-const _services = require("../services");
-function _define_property(obj, key, value) {
-    if (key in obj) {
-        Object.defineProperty(obj, key, {
-            value: value,
-            enumerable: true,
-            configurable: true,
-            writable: true
-        });
-    } else {
-        obj[key] = value;
-    }
-    return obj;
-}
-function _ts_decorate(decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for(var i = decorators.length - 1; i >= 0; i--)if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-}
-function _ts_metadata(k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-}
-function _ts_param(paramIndex, decorator) {
-    return function(target, key) {
-        decorator(target, key, paramIndex);
-    };
-}
-let TranslationController = class TranslationController extends (0, _classes.createApiController)(_dtos.CreateTranslationDto, _dtos.UpdateTranslationDto, _dtos.TranslationResponseDto, {
-    entityName: 'translation',
-    security: {
-        insert: {
-            level: 'permission',
-            permissions: [
-                _classes.TRANSLATION_PERMISSIONS.CREATE
-            ]
-        },
-        insertMany: {
-            level: 'permission',
-            permissions: [
-                _classes.TRANSLATION_PERMISSIONS.CREATE
-            ]
-        },
-        getById: {
-            level: 'permission',
-            permissions: [
-                _classes.TRANSLATION_PERMISSIONS.READ
-            ]
-        },
-        getAll: {
-            level: 'permission',
-            permissions: [
-                _classes.TRANSLATION_PERMISSIONS.READ
-            ]
-        },
-        update: {
-            level: 'permission',
-            permissions: [
-                _classes.TRANSLATION_PERMISSIONS.UPDATE
-            ]
-        },
-        updateMany: {
-            level: 'permission',
-            permissions: [
-                _classes.TRANSLATION_PERMISSIONS.UPDATE
-            ]
-        },
-        delete: {
-            level: 'permission',
-            permissions: [
-                _classes.TRANSLATION_PERMISSIONS.DELETE
-            ]
-        }
-    }
-}) {
-    async getByLanguage(body) {
-        const data = await this.service.getByLanguageCode(body.languageCode, body.modules);
-        return {
-            success: true,
-            message: 'Translations retrieved successfully',
-            messageKey: _config.TRANSLATION_MESSAGES.BY_LANGUAGE_SUCCESS,
-            data
-        };
-    }
-    async updateManyValues(body, _user) {
-        const data = await this.service.bulkUpdate(body.translations);
-        return {
-            success: true,
-            message: `${data.length} translations updated`,
-            messageKey: _config.TRANSLATION_MESSAGES.UPDATE_MANY_SUCCESS,
-            messageVariables: {
-                count: data.length
-            },
-            data,
-            meta: {
-                count: data.length
-            }
-        };
-    }
-    async getCounts(_user) {
-        const data = await this.service.getTranslationCounts();
-        return {
-            success: true,
-            message: 'Translation counts retrieved successfully',
-            messageKey: _config.TRANSLATION_MESSAGES.GET_ALL_SUCCESS,
-            data
-        };
-    }
-    constructor(service){
-        super(service), _define_property(this, "service", void 0), this.service = service;
-    }
-};
-_ts_decorate([
-    (0, _common.Post)('get-by-language'),
-    (0, _swagger.ApiOperation)({
-        summary: 'Get translations for a language (optionally filtered by modules)'
-    }),
-    (0, _swagger.ApiResponse)({
-        status: 200
-    }),
-    _ts_param(0, (0, _common.Body)()),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof _dtos.GetTranslationsByLanguageDto === "undefined" ? Object : _dtos.GetTranslationsByLanguageDto
-    ]),
-    _ts_metadata("design:returntype", Promise)
-], TranslationController.prototype, "getByLanguage", null);
-_ts_decorate([
-    (0, _common.Post)('update-many-values'),
-    (0, _common.UseGuards)(_guards.JwtAuthGuard, _guards.PermissionGuard),
-    (0, _swagger.ApiBearerAuth)(),
-    (0, _decorators.RequirePermission)(_classes.TRANSLATION_PERMISSIONS.UPDATE),
-    (0, _swagger.ApiOperation)({
-        summary: 'Bulk update translation values'
-    }),
-    (0, _swagger.ApiResponse)({
-        status: 200,
-        type: [
-            _dtos.TranslationResponseDto
-        ]
-    }),
-    _ts_param(0, (0, _common.Body)()),
-    _ts_param(1, (0, _decorators.CurrentUser)()),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof _dtos.BulkUpdateTranslationsDto === "undefined" ? Object : _dtos.BulkUpdateTranslationsDto,
-        typeof _interfaces.ILoggedUserInfo === "undefined" ? Object : _interfaces.ILoggedUserInfo
-    ]),
-    _ts_metadata("design:returntype", Promise)
-], TranslationController.prototype, "updateManyValues", null);
-_ts_decorate([
-    (0, _common.Post)('get-counts'),
-    (0, _common.UseGuards)(_guards.JwtAuthGuard, _guards.PermissionGuard),
-    (0, _swagger.ApiBearerAuth)(),
-    (0, _decorators.RequirePermission)(_classes.TRANSLATION_PERMISSIONS.READ),
-    (0, _swagger.ApiOperation)({
-        summary: 'Get translation counts per translation key'
-    }),
-    (0, _swagger.ApiResponse)({
-        status: 200
-    }),
-    _ts_param(0, (0, _decorators.CurrentUser)()),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof _interfaces.ILoggedUserInfo === "undefined" ? Object : _interfaces.ILoggedUserInfo
-    ]),
-    _ts_metadata("design:returntype", Promise)
-], TranslationController.prototype, "getCounts", null);
-TranslationController = _ts_decorate([
-    (0, _swagger.ApiTags)('Localization - Translation'),
-    (0, _common.Controller)('localization/translation'),
-    _ts_param(0, (0, _common.Inject)(_services.TranslationService)),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof _services.TranslationService === "undefined" ? Object : _services.TranslationService
-    ])
-], TranslationController);

package/cjs/controllers/translation.controller.spec.js

@@ -1,169 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-const _testing = require("@nestjs/testing");
-const _modules = require("@flusys/nestjs-shared/modules");
-const _loggedusermock = require("@test-utils/mocks/logged-user.mock");
-const _translationcontroller = require("./translation.controller");
-const _services = require("../services");
-function buildTranslation(overrides = {}) {
-    return {
-        id: 'translation-1',
-        languageId: 'lang-en',
-        translationKeyId: 'tkey-1',
-        value: 'Login successful',
-        isVerified: false,
-        isActive: true,
-        createdAt: new Date(),
-        updatedAt: new Date(),
-        deletedAt: null,
-        createdById: null,
-        updatedById: null,
-        deletedById: null,
-        ...overrides
-    };
-}
-describe('TranslationController', ()=>{
-    let controller;
-    let mockService;
-    beforeEach(async ()=>{
-        mockService = {
-            insert: jest.fn(),
-            findById: jest.fn(),
-            getAll: jest.fn(),
-            update: jest.fn(),
-            delete: jest.fn(),
-            getByLanguageCode: jest.fn(),
-            bulkUpdate: jest.fn(),
-            getTranslationCounts: jest.fn()
-        };
-        const module = await _testing.Test.createTestingModule({
-            controllers: [
-                _translationcontroller.TranslationController
-            ],
-            providers: [
-                {
-                    provide: _services.TranslationService,
-                    useValue: mockService
-                },
-                {
-                    provide: _modules.UtilsService,
-                    useValue: {}
-                }
-            ]
-        }).compile();
-        controller = module.get(_translationcontroller.TranslationController);
-    });
-    describe('getByLanguage', ()=>{
-        it('returns the translations map for the requested language and modules', async ()=>{
-            mockService.getByLanguageCode.mockResolvedValue({
-                'auth.login.success': 'Login successful'
-            });
-            const result = await controller.getByLanguage({
-                languageCode: 'en',
-                modules: [
-                    'auth'
-                ]
-            });
-            expect(mockService.getByLanguageCode).toHaveBeenCalledWith('en', [
-                'auth'
-            ]);
-            expect(result).toEqual({
-                success: true,
-                message: 'Translations retrieved successfully',
-                messageKey: 'translation.by.language.success',
-                data: {
-                    'auth.login.success': 'Login successful'
-                }
-            });
-        });
-        it('returns an empty map (fallback) for an unknown language code without throwing', async ()=>{
-            mockService.getByLanguageCode.mockResolvedValue({});
-            const result = await controller.getByLanguage({
-                languageCode: 'xx'
-            });
-            expect(result.success).toBe(true);
-            expect(result.data).toEqual({});
-        });
-        it('requests translations for all modules when modules is omitted', async ()=>{
-            mockService.getByLanguageCode.mockResolvedValue({});
-            await controller.getByLanguage({
-                languageCode: 'en'
-            });
-            expect(mockService.getByLanguageCode).toHaveBeenCalledWith('en', undefined);
-        });
-    });
-    describe('updateManyValues', ()=>{
-        it('bulk updates translations and reports the updated count', async ()=>{
-            const updated = [
-                buildTranslation(),
-                buildTranslation({
-                    id: 'translation-2'
-                })
-            ];
-            mockService.bulkUpdate.mockResolvedValue(updated);
-            const result = await controller.updateManyValues({
-                translations: [
-                    {
-                        languageId: 'lang-en',
-                        translationKeyId: 'tkey-1',
-                        value: 'Login successful'
-                    }
-                ]
-            }, (0, _loggedusermock.buildMockUser)());
-            expect(result).toEqual({
-                success: true,
-                message: '2 translations updated',
-                messageKey: 'translation.update.many.success',
-                messageVariables: {
-                    count: 2
-                },
-                data: updated,
-                meta: {
-                    count: 2
-                }
-            });
-        });
-        it('reports zero updates for an empty batch without calling the service twice', async ()=>{
-            mockService.bulkUpdate.mockResolvedValue([]);
-            const result = await controller.updateManyValues({
-                translations: []
-            }, (0, _loggedusermock.buildMockUser)());
-            expect(mockService.bulkUpdate).toHaveBeenCalledTimes(1);
-            expect(result.meta).toEqual({
-                count: 0
-            });
-            expect(result.message).toBe('0 translations updated');
-        });
-        it('propagates errors raised during the bulk transaction (e.g. rollback surfaced as a rejection)', async ()=>{
-            mockService.bulkUpdate.mockRejectedValue(new Error('transaction rolled back'));
-            await expect(controller.updateManyValues({
-                translations: []
-            }, (0, _loggedusermock.buildMockUser)())).rejects.toThrow('transaction rolled back');
-        });
-    });
-    describe('getCounts', ()=>{
-        it('returns translation counts keyed by translation key id', async ()=>{
-            mockService.getTranslationCounts.mockResolvedValue({
-                'tkey-1': 3,
-                'tkey-2': 1
-            });
-            const result = await controller.getCounts((0, _loggedusermock.buildMockUser)());
-            expect(result).toEqual({
-                success: true,
-                message: 'Translation counts retrieved successfully',
-                messageKey: 'translation.get.all.success',
-                data: {
-                    'tkey-1': 3,
-                    'tkey-2': 1
-                }
-            });
-        });
-        it('returns an empty object when there are no translations yet', async ()=>{
-            mockService.getTranslationCounts.mockResolvedValue({});
-            const result = await controller.getCounts((0, _loggedusermock.buildMockUser)());
-            expect(result.data).toEqual({});
-        });
-    });
-});

package/cjs/docs/index.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "localizationSwaggerConfig", {
-    enumerable: true,
-    get: function() {
-        return _localizationswaggerconfig.localizationSwaggerConfig;
-    }
-});
-const _localizationswaggerconfig = require("./localization-swagger.config");

package/cjs/docs/localization-swagger.config.js

@@ -1,111 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "localizationSwaggerConfig", {
-    enumerable: true,
-    get: function() {
-        return localizationSwaggerConfig;
-    }
-});
-function localizationSwaggerConfig(bootstrapConfig) {
-    const isMultiTenant = bootstrapConfig?.databaseMode === 'multi-tenant';
-    const multiTenantNote = isMultiTenant ? `\n> **Multi-Tenant Mode**: Include \`x-tenant-id\` header to target a specific tenant database.\n` : '';
-    return {
-        title: 'Localization API',
-        description: `
-## Localization API
-${multiTenantNote}
-
-Database-driven internationalization system. Manage languages, translation keys, and translations — all stored in the database and served via API.
-
-## Features
-
-### 🌐 Language Management
-- Create and manage languages with LTR/RTL direction support
-- Set a default language
-- Mark languages as readonly to protect seeded entries
-
-### 🔑 Translation Keys
-- Organize keys by module for lazy loading (e.g. \`auth\`, \`iam\`, \`common\`)
-- Dot-case naming convention: \`auth.login.title\`, \`common.button.save\`
-- Support for interpolation variables: \`['count', 'name']\`
-- Readonly protection — system keys cannot be deleted or have their key/module changed
-
-### 📝 Translations
-- Store translated values per language per key
-- Mark translations as verified
-- Bulk upsert in a single transaction — create or update in one call
-- Detect missing translations for a given language
-- Track translation counts per key
-
-### 🚀 Angular Lazy Loading
-- Public endpoints return flat key-value maps: \`{ "auth.login.title": "Sign In" }\`
-- Filter by one or multiple modules to load only what is needed
-- No authentication required for translation retrieval endpoints
-
-## Key Naming Convention
-
-Translation keys use dot-case and must be unique per module:
-
-\`\`\`
-auth.login.title
-auth.login.submit
-auth.register.email.placeholder
-common.button.save
-common.button.cancel
-iam.role.create.success
-\`\`\`
-
-## Module-Based Lazy Loading
-
-Keys are grouped by \`module\` so the frontend loads translations on demand:
-
-| Module | Purpose |
-|--------|---------|
-| auth | Login, register, profile pages |
-| iam | Roles, permissions management |
-| storage | Files and folders |
-| event-manager | Calendar events |
-| form-builder | Dynamic form fields |
-| notification | Notification titles and messages |
-| email | Email template content |
-| common | Shared labels used across modules |
-
-## Public vs Authenticated Endpoints
-
-**Public** (no auth required — used by Angular to load translations):
-- POST /localization/language/get-active
-- POST /localization/language/get-default
-- POST /localization/translation/get-by-language
-- POST /localization/translation/get-by-module
-
-**Authenticated** (require JWT + permission):
-- All create, update, delete operations
-- get-missing, get-counts, update-many-values
-
-## Bulk Update
-
-POST /localization/translation/update-many-values accepts an array of translation objects. Each item is either an upsert (provide **id** to update, omit to create). The entire batch runs in a single database transaction.
-
-## Readonly Protection
-
-Languages and translation keys with \`isReadonly: true\` are protected at the service layer:
-- Cannot be deleted
-- Key and module fields cannot be modified
-
-Use \`isReadonly\` to protect entries that are seeded at startup and should not be changed by users.
-
-## Getting Started
-
-1. **Authenticate**: Obtain JWT token from POST /auth/login
-2. **Create languages**: Add languages via POST /localization/language/insert
-3. **Seed translation keys**: Bulk insert keys via POST /localization/translation-key/insert-many
-4. **Add translations**: Use POST /localization/translation/update-many-values for bulk upsert
-5. **Load in Angular**: Call POST /localization/translation/get-by-language with { languageCode: "en", modules: ["auth"] }
-    `,
-        version: '1.0',
-        path: 'api/docs/localization',
-        bearerAuth: true
-    };
-}

package/cjs/docs/localization-swagger.config.spec.js

@@ -1,30 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-const _localizationswaggerconfig = require("./localization-swagger.config");
-describe('localizationSwaggerConfig', ()=>{
-    it('should build a static config with no multi-tenant note by default', ()=>{
-        const config = (0, _localizationswaggerconfig.localizationSwaggerConfig)();
-        expect(config.title).toBe('Localization API');
-        expect(config.path).toBe('api/docs/localization');
-        expect(config.bearerAuth).toBe(true);
-        expect(config.description).not.toContain('Multi-Tenant Mode');
-    });
-    it('should include the multi-tenant note only for multi-tenant database mode', ()=>{
-        const multiTenant = (0, _localizationswaggerconfig.localizationSwaggerConfig)({
-            databaseMode: 'multi-tenant'
-        });
-        const single = (0, _localizationswaggerconfig.localizationSwaggerConfig)({
-            databaseMode: 'single'
-        });
-        expect(multiTenant.description).toContain('Multi-Tenant Mode');
-        expect(single.description).not.toContain('Multi-Tenant Mode');
-    });
-    it('should treat any non-"multi-tenant" value as single-database mode', ()=>{
-        const config = (0, _localizationswaggerconfig.localizationSwaggerConfig)({
-            databaseMode: 'unexpected-value'
-        });
-        expect(config.description).not.toContain('Multi-Tenant Mode');
-    });
-});

package/cjs/dtos/index.js

@@ -1,20 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-_export_star(require("./language.dto"), exports);
-_export_star(require("./translation-key.dto"), exports);
-_export_star(require("./translation.dto"), exports);
-function _export_star(from, to) {
-    Object.keys(from).forEach(function(k) {
-        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
-            Object.defineProperty(to, k, {
-                enumerable: true,
-                get: function() {
-                    return from[k];
-                }
-            });
-        }
-    });
-    return from;
-}