@lucaapp/service-utils 5.0.0 → 5.1.0

package/dist/lib/negotiator/language.d.ts

@@ -4,6 +4,35 @@ export declare const DEFAULT_LANGUAGE_WHEN_NO_HEADER = "de";
 export declare const DEFAULT_LANGUAGE_WHEN_HEADER = "en";
 export declare const AVAILABLE_LANGUAGES: string[];
 type LanguageOptions = typeof AVAILABLE_LANGUAGES[number];
+/**
+ * Checks if a language code is a supported InternalLanguage.
+ *
+ * @param lang - Language code to check
+ * @returns true if the language is supported, false otherwise
+ *
+ * @example
+ * ```typescript
+ * isInternalLanguage('de') // returns true
+ * isInternalLanguage('en') // returns true
+ * isInternalLanguage('fr') // returns false
+ * ```
+ */
+export declare const isInternalLanguage: (lang: string) => lang is InternalLanguages;
+/**
+ * Safely converts a language code to an InternalLanguage.
+ * If the language is not supported, falls back to 'en'.
+ *
+ * @param lang - Language code to convert
+ * @returns The language if supported, otherwise 'en'
+ *
+ * @example
+ * ```typescript
+ * toInternalLanguage('de') // returns 'de'
+ * toInternalLanguage('en') // returns 'en'
+ * toInternalLanguage('fr') // returns 'en' (fallback)
+ * ```
+ */
+export declare const toInternalLanguage: (lang: string) => InternalLanguages;
 export declare const parseAcceptLanguageHeader: (header?: string) => LanguageOptions;
 /**
  * @deprecated Use getPreferredLanguageFromRequestHeaders instead.

package/dist/lib/negotiator/language.js

@@ -3,11 +3,46 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getPreferredLanguageFromRequestHeaders = exports.getPreferredLanguageFromRequest = exports.parseAcceptLanguageHeader = exports.AVAILABLE_LANGUAGES = exports.DEFAULT_LANGUAGE_WHEN_HEADER = exports.DEFAULT_LANGUAGE_WHEN_NO_HEADER = void 0;
+exports.getPreferredLanguageFromRequestHeaders = exports.getPreferredLanguageFromRequest = exports.parseAcceptLanguageHeader = exports.toInternalLanguage = exports.isInternalLanguage = exports.AVAILABLE_LANGUAGES = exports.DEFAULT_LANGUAGE_WHEN_HEADER = exports.DEFAULT_LANGUAGE_WHEN_NO_HEADER = void 0;
 const negotiator_1 = __importDefault(require("negotiator"));
 exports.DEFAULT_LANGUAGE_WHEN_NO_HEADER = 'de';
 exports.DEFAULT_LANGUAGE_WHEN_HEADER = 'en';
 exports.AVAILABLE_LANGUAGES = ['en', 'de'];
+/**
+ * Checks if a language code is a supported InternalLanguage.
+ *
+ * @param lang - Language code to check
+ * @returns true if the language is supported, false otherwise
+ *
+ * @example
+ * ```typescript
+ * isInternalLanguage('de') // returns true
+ * isInternalLanguage('en') // returns true
+ * isInternalLanguage('fr') // returns false
+ * ```
+ */
+const isInternalLanguage = (lang) => {
+    return exports.AVAILABLE_LANGUAGES.includes(lang);
+};
+exports.isInternalLanguage = isInternalLanguage;
+/**
+ * Safely converts a language code to an InternalLanguage.
+ * If the language is not supported, falls back to 'en'.
+ *
+ * @param lang - Language code to convert
+ * @returns The language if supported, otherwise 'en'
+ *
+ * @example
+ * ```typescript
+ * toInternalLanguage('de') // returns 'de'
+ * toInternalLanguage('en') // returns 'en'
+ * toInternalLanguage('fr') // returns 'en' (fallback)
+ * ```
+ */
+const toInternalLanguage = (lang) => {
+    return (0, exports.isInternalLanguage)(lang) ? lang : 'en';
+};
+exports.toInternalLanguage = toInternalLanguage;
 const parseAcceptLanguageHeader = (header) => {
     if (!header) {
         return exports.DEFAULT_LANGUAGE_WHEN_NO_HEADER;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucaapp/service-utils",
-  "version": "5.0.0",
+  "version": "5.1.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [