@efa-one/sdk 1.14.1 → 1.15.0

package/README.md

@@ -15,6 +15,7 @@ sub-paths — this keeps `express` out of the frontend and `react` out of the ba
 | `@efa-one/sdk/backend` | Node/Express | Auth + token exchange (`requireAuth`, `createExchangeRouter`, `requireInternalOrAuth` …), health router, service discovery + gateway client (`serviceClient`, `resolveService`), clients for audit/reporting/mail/notifications, permission resolution/registration (`getUserPermissions`, `registerPermissions`, `checkPermission`), capability registry (`registerApiMetadata`), backend i18n |
 | `@efa-one/sdk/frontend` | Browser/React | postMessage IPC (`registerAppInfo`, `sendAtStart`, `navigateToApp`, `notifyRouteChange` …), react-i18next factory (`initI18n`), `DevHeader` |
 | `@efa-one/sdk/frontend/ui` | Browser/React | The efa-one design-system kit: `Button`, `Input`, `Badge`, `Alert`, `Dialog`, `DropdownMenu`, `Tooltip`, `EmptyState`, `Skeleton`, `RecordDialog`, and the **`DataTable`** (sortable/filterable/groupable list with per-user persisted view; reflows to stacked cards below 640px). Also exports `useIsMobile` — the platform-wide 640px breakpoint hook. Ship its companion CSS once: `import '@efa-one/sdk/frontend/ui/styles.css'` |
+| `@efa-one/sdk/frontend/format` | Browser | Platform-wide date/time display — `formatDate` (`01.09.2026`), `formatDateTime` (`01.09.2026, 11:05`), `formatTime`, `formatFileStamp`, `localeForLanguage`. Always use these instead of `toLocaleDateString`/`toLocaleString`: without an options object those render `1.9.2026`, and without a locale argument they follow the browser language (`9/1/2026`) |
 | `@efa-one/sdk/frontend/viewPreferences` | Browser/React | Persistence seam for `DataTable` — `createViewPreferencesClient()` (standard `/api/view-preferences/:listId` adapter) + `useViewPreferences()` |
 
 Every individual module is also reachable directly, e.g.

package/frontend/format.d.ts

@@ -0,0 +1,14 @@
+export type DateInput = Date | string | number | null | undefined;
+export interface DateFormatOptions {
+    locale?: string;
+    timeZone?: string;
+    fallback?: string;
+    withSeconds?: boolean;
+}
+export declare const DEFAULT_DATE_LOCALE = "de-DE";
+export declare const DEFAULT_DATE_FALLBACK = "\u2014";
+export declare function localeForLanguage(language?: string | null): string;
+export declare function formatDate(value: DateInput, opts?: DateFormatOptions): string;
+export declare function formatTime(value: DateInput, opts?: DateFormatOptions): string;
+export declare function formatDateTime(value: DateInput, opts?: DateFormatOptions): string;
+export declare function formatFileStamp(value: DateInput, opts?: Pick<DateFormatOptions, 'timeZone'>): string;

package/frontend/format.js

@@ -0,0 +1,64 @@
+export const DEFAULT_DATE_LOCALE = 'de-DE';
+export const DEFAULT_DATE_FALLBACK = '—';
+export function localeForLanguage(language) {
+    const lang = (language ?? '').trim().toLowerCase();
+    if (!lang)
+        return DEFAULT_DATE_LOCALE;
+    if (lang === 'de' || lang.startsWith('de-'))
+        return DEFAULT_DATE_LOCALE;
+    if (lang === 'en' || lang.startsWith('en-'))
+        return 'en-US';
+    return language;
+}
+function toDate(value) {
+    if (value === null || value === undefined || value === '')
+        return null;
+    const d = value instanceof Date ? value : new Date(value);
+    return Number.isNaN(d.getTime()) ? null : d;
+}
+function base(opts) {
+    return opts?.timeZone ? { timeZone: opts.timeZone } : {};
+}
+function run(value, opts, fmt) {
+    const d = toDate(value);
+    if (!d)
+        return opts?.fallback ?? DEFAULT_DATE_FALLBACK;
+    return new Intl.DateTimeFormat(opts?.locale ?? DEFAULT_DATE_LOCALE, { ...base(opts), ...fmt }).format(d);
+}
+export function formatDate(value, opts) {
+    return run(value, opts, { day: '2-digit', month: '2-digit', year: 'numeric' });
+}
+export function formatTime(value, opts) {
+    return run(value, opts, {
+        hour: '2-digit',
+        minute: '2-digit',
+        ...(opts?.withSeconds ? { second: '2-digit' } : {}),
+        hourCycle: 'h23',
+    });
+}
+export function formatDateTime(value, opts) {
+    return run(value, opts, {
+        day: '2-digit',
+        month: '2-digit',
+        year: 'numeric',
+        hour: '2-digit',
+        minute: '2-digit',
+        ...(opts?.withSeconds ? { second: '2-digit' } : {}),
+        hourCycle: 'h23',
+    });
+}
+export function formatFileStamp(value, opts) {
+    const d = toDate(value) ?? new Date();
+    const parts = new Intl.DateTimeFormat('en-CA', {
+        ...(opts?.timeZone ? { timeZone: opts.timeZone } : {}),
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+        hourCycle: 'h23',
+    }).formatToParts(d);
+    const p = (type) => parts.find((x) => x.type === type)?.value ?? '';
+    return `${p('year')}-${p('month')}-${p('day')}_${p('hour')}-${p('minute')}-${p('second')}`;
+}

package/frontend/index.d.ts

@@ -1,4 +1,5 @@
 export * from './ipc.js';
+export * from './format.js';
 export { useIsMobile, MOBILE_QUERY } from './useIsMobile.js';
 export * from './i18n.js';
 export { default as DevHeader } from './DevHeader.js';

package/frontend/index.js

@@ -1,4 +1,5 @@
 export * from './ipc.js';
+export * from './format.js';
 export { useIsMobile, MOBILE_QUERY } from './useIsMobile.js';
 export * from './i18n.js';
 export { default as DevHeader } from './DevHeader.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@efa-one/sdk",
-  "version": "1.14.1",
+  "version": "1.15.0",
   "description": "Offizielles SDK für efa-one-Apps: Auth/Session, Service-Discovery, Gateway-Client, Audit/Reporting/Mail/Notifications, Permission- und Capability-Registrierung sowie das Frontend-IPC-/i18n-Toolkit.",
   "license": "Apache-2.0",
   "type": "commonjs",