blendsdk 5.33.0

package/dist/webafx-cache/types.d.ts

@@ -0,0 +1,206 @@
+/**
+ * Type definitions and constants for the @blendsdk/webafx-cache package.
+ *
+ * Defines configuration interfaces for all cache and pub/sub providers
+ * (Redis, In-Memory) and their environment-based factories. Constants
+ * provide sensible defaults for service naming, TTL, key formatting,
+ * and channel prefix handling.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Shared Redis connection configuration.
+ *
+ * Extracted as a common base so both cache and pub/sub Redis providers
+ * can share the same connection field definitions without duplication.
+ *
+ * When `url` is provided, it takes precedence over host/port/password/db.
+ */
+export interface RedisConnectionConfig {
+    /** Redis host. Default: 'localhost' */
+    host?: string;
+    /** Redis port. Default: 6379 */
+    port?: number;
+    /** Redis password (optional) */
+    password?: string;
+    /** Redis database index (0-15). Default: 0 */
+    db?: number;
+    /** Redis connection URL (overrides host/port/password/db if provided) */
+    url?: string;
+    /** Connection timeout in milliseconds. Default: 5000 */
+    connectTimeout?: number;
+    /** Maximum number of reconnection attempts. Default: 3 */
+    maxRetriesPerRequest?: number;
+}
+/**
+ * Base configuration shared by all cache providers.
+ * Every provider requires at minimum a rootKey for namespace isolation.
+ */
+export interface CacheProviderConfig {
+    /** Root key prefix for all cache keys (e.g., 'MyApp') */
+    rootKey: string;
+    /**
+     * Service name for WebAFX service container registration.
+     * Defaults to 'cache'. Use different names for multi-cache scenarios.
+     */
+    serviceName?: string;
+    /** Default TTL in seconds. 0 means no expiry. Default: 0 */
+    defaultTTL?: number;
+}
+/**
+ * Redis-specific cache configuration.
+ *
+ * Extends base cache config with shared Redis connection options.
+ * This is a non-breaking refactor — the interface exposes the exact
+ * same fields as before, but Redis connection fields now come from
+ * the shared `RedisConnectionConfig` base.
+ *
+ * When `url` is provided, it takes precedence over host/port/password/db.
+ */
+export interface RedisCacheConfig extends CacheProviderConfig, RedisConnectionConfig {
+}
+/**
+ * In-memory specific configuration.
+ * Extends base config with memory management options.
+ */
+export interface MemoryCacheConfig extends CacheProviderConfig {
+    /** Cleanup interval for expired entries in milliseconds. Default: 60000 (1 min) */
+    cleanupIntervalMs?: number;
+}
+/**
+ * Configuration for the createCache() environment-based factory.
+ * Determines which backend to create based on the 'type' field.
+ *
+ * Redis-specific fields are only used when type === 'redis'.
+ * Memory-specific fields are only used when type === 'memory'.
+ */
+export interface CacheFactoryConfig {
+    /** Cache backend type */
+    type: "redis" | "memory";
+    /** Root key prefix for all cache keys */
+    rootKey: string;
+    /** Service name for WebAFX service container. Default: 'cache' */
+    serviceName?: string;
+    /** Default TTL in seconds. Default: 0 */
+    defaultTTL?: number;
+    /** Redis host */
+    host?: string;
+    /** Redis port */
+    port?: number;
+    /** Redis password */
+    password?: string;
+    /** Redis database index */
+    db?: number;
+    /** Redis connection URL */
+    url?: string;
+    /** Cleanup interval in ms */
+    cleanupIntervalMs?: number;
+}
+/**
+ * Base configuration shared by all pub/sub providers.
+ *
+ * The `channelPrefix` provides namespace isolation — all channels are
+ * automatically prefixed so multiple applications can share the same
+ * Redis instance without channel name collisions.
+ */
+export interface PubSubProviderConfig {
+    /**
+     * Channel prefix for namespace isolation.
+     * Applied to all channels automatically.
+     *
+     * @example
+     * // prefix='MyApp' → channel 'order:new' becomes 'MyApp:order:new'
+     */
+    channelPrefix?: string;
+    /**
+     * Service name for WebAFX service container registration.
+     * Default: 'pubsub'. Use different names for multi-pubsub scenarios.
+     */
+    serviceName?: string;
+}
+/**
+ * Redis-specific pub/sub configuration.
+ *
+ * Extends base pub/sub config with shared Redis connection options.
+ * The provider creates **two** ioredis connections internally:
+ * one for publishing and one for subscribing (Redis requires
+ * a dedicated connection once it enters subscriber mode).
+ */
+export interface RedisPubSubConfig extends PubSubProviderConfig, RedisConnectionConfig {
+}
+/**
+ * In-memory specific pub/sub configuration.
+ * No additional fields beyond the base config.
+ */
+export interface MemoryPubSubConfig extends PubSubProviderConfig {
+}
+/**
+ * Configuration for the createPubSub() environment-based factory.
+ * Determines which backend to create based on the 'type' field.
+ *
+ * Redis-specific fields are only used when type === 'redis'.
+ */
+export interface PubSubFactoryConfig extends PubSubProviderConfig {
+    /** Pub/sub backend type */
+    type: "redis" | "memory";
+    /** Redis host */
+    host?: string;
+    /** Redis port */
+    port?: number;
+    /** Redis password */
+    password?: string;
+    /** Redis database index */
+    db?: number;
+    /** Redis connection URL */
+    url?: string;
+}
+/**
+ * Message envelope delivered to subscription handlers.
+ *
+ * Contains the deserialized payload and metadata about the channel
+ * and (for pattern subscriptions) the pattern that matched.
+ * The `channel` field always contains the user-facing name
+ * (prefix stripped), not the internal prefixed name.
+ */
+export interface PubSubMessage<T = unknown> {
+    /** The channel the message was published to (prefix stripped) */
+    channel: string;
+    /** The deserialized message payload */
+    data: T;
+    /** For pattern subscriptions: the pattern that matched (prefix stripped) */
+    pattern?: string;
+}
+/**
+ * Handler function for pub/sub messages.
+ *
+ * Can be synchronous or asynchronous. Errors thrown by handlers are
+ * caught and logged — they do not break other subscribers or crash
+ * the subscriber connection.
+ */
+export type MessageHandler<T = unknown> = (message: PubSubMessage<T>) => void | Promise<void>;
+/**
+ * Subscription definition for declarative registration via plugin config.
+ *
+ * Exactly one of `channel` or `pattern` must be provided.
+ * - `channel` subscribes to an exact channel (SUBSCRIBE)
+ * - `pattern` subscribes to a glob pattern (PSUBSCRIBE)
+ */
+export interface SubscriptionDefinition<T = unknown> {
+    /** Exact channel name (mutually exclusive with `pattern`) */
+    channel?: string;
+    /** Channel pattern with glob wildcards (mutually exclusive with `channel`) */
+    pattern?: string;
+    /** Handler function invoked when a matching message arrives */
+    handler: MessageHandler<T>;
+}
+/** Default service name for cache when not specified */
+export declare const DEFAULT_SERVICE_NAME = "cache";
+/** Default TTL (0 = no expiry) */
+export declare const DEFAULT_TTL = 0;
+/** Key separator between rootKey and user-provided key */
+export declare const KEY_SEPARATOR = ":";
+/** Default service name for pub/sub when not specified */
+export declare const DEFAULT_PUBSUB_SERVICE_NAME = "pubsub";
+/** Channel prefix separator (same as key separator for consistency) */
+export declare const CHANNEL_SEPARATOR = ":";
+//# sourceMappingURL=types.d.ts.map

package/dist/webafx-cache/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/webafx-cache/types.js

@@ -0,0 +1,27 @@
+/**
+ * Type definitions and constants for the @blendsdk/webafx-cache package.
+ *
+ * Defines configuration interfaces for all cache and pub/sub providers
+ * (Redis, In-Memory) and their environment-based factories. Constants
+ * provide sensible defaults for service naming, TTL, key formatting,
+ * and channel prefix handling.
+ *
+ * @packageDocumentation
+ */
+// ---------------------------------------------------------------------------
+// Cache Constants
+// ---------------------------------------------------------------------------
+/** Default service name for cache when not specified */
+export const DEFAULT_SERVICE_NAME = "cache";
+/** Default TTL (0 = no expiry) */
+export const DEFAULT_TTL = 0;
+/** Key separator between rootKey and user-provided key */
+export const KEY_SEPARATOR = ":";
+// ---------------------------------------------------------------------------
+// Pub/Sub Constants
+// ---------------------------------------------------------------------------
+/** Default service name for pub/sub when not specified */
+export const DEFAULT_PUBSUB_SERVICE_NAME = "pubsub";
+/** Channel prefix separator (same as key separator for consistency) */
+export const CHANNEL_SEPARATOR = ":";
+//# sourceMappingURL=types.js.map

package/dist/webafx-cache/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAqPH,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,wDAAwD;AACxD,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAE5C,kCAAkC;AAClC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAE7B,0DAA0D;AAC1D,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AAEjC,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,0DAA0D;AAC1D,MAAM,CAAC,MAAM,2BAA2B,GAAG,QAAQ,CAAC;AAEpD,uEAAuE;AACvE,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC"}

package/dist/webafx-i18n/i18n-plugin.d.ts

@@ -0,0 +1,29 @@
+import type { PluginDefinition } from "../webafx/index.js";
+import type { I18nPluginConfig } from "./types.js";
+/**
+ * Create a WebAFX PluginDefinition for i18n.
+ *
+ * This is the main entry point. It:
+ * 1. Loads translations from all configured sources at startup
+ * 2. Creates a Translator with the merged catalog
+ * 3. Registers the Translator as a singleton service
+ * 4. Registers a per-request "locale" service that resolves the request locale
+ * 5. Optionally subscribes to a pub/sub reload channel
+ *
+ * @param config - Plugin configuration
+ * @returns WebAFX PluginDefinition
+ *
+ * @example
+ * ```typescript
+ * import { createI18nPlugin, jsonFileSource } from "./index.js";
+ *
+ * app.use(createI18nPlugin({
+ *     defaultLocale: "en",
+ *     sources: [
+ *         jsonFileSource({ paths: ["./translations/*.json"] }),
+ *     ],
+ * }));
+ * ```
+ */
+export declare function createI18nPlugin(config: I18nPluginConfig): PluginDefinition;
+//# sourceMappingURL=i18n-plugin.d.ts.map

package/dist/webafx-i18n/i18n-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-plugin.d.ts","sourceRoot":"","sources":["../src/i18n-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,kBAAkB,CAAC;AAGzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAYnD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAwF3E"}

package/dist/webafx-i18n/i18n-plugin.js

@@ -0,0 +1,145 @@
+import { Translator, mergeCatalogs } from "../i18n/index.js";
+import { resolveLocale } from "./locale-resolver.js";
+/** Default plugin priority */
+const DEFAULT_PRIORITY = 40;
+/** Default service names */
+const DEFAULT_SERVICE_NAME = "i18n";
+const DEFAULT_LOCALE_SERVICE_NAME = "locale";
+const DEFAULT_PUBSUB_SERVICE_NAME = "pubsub";
+const DEFAULT_COOKIE_NAME = "locale";
+/**
+ * Create a WebAFX PluginDefinition for i18n.
+ *
+ * This is the main entry point. It:
+ * 1. Loads translations from all configured sources at startup
+ * 2. Creates a Translator with the merged catalog
+ * 3. Registers the Translator as a singleton service
+ * 4. Registers a per-request "locale" service that resolves the request locale
+ * 5. Optionally subscribes to a pub/sub reload channel
+ *
+ * @param config - Plugin configuration
+ * @returns WebAFX PluginDefinition
+ *
+ * @example
+ * ```typescript
+ * import { createI18nPlugin, jsonFileSource } from "./index.js";
+ *
+ * app.use(createI18nPlugin({
+ *     defaultLocale: "en",
+ *     sources: [
+ *         jsonFileSource({ paths: ["./translations/*.json"] }),
+ *     ],
+ * }));
+ * ```
+ */
+export function createI18nPlugin(config) {
+    const serviceName = config.serviceName ?? DEFAULT_SERVICE_NAME;
+    const localeServiceName = config.localeServiceName ?? DEFAULT_LOCALE_SERVICE_NAME;
+    const defaultLocale = config.defaultLocale ?? "en";
+    const cookieName = config.localeCookieName ?? DEFAULT_COOKIE_NAME;
+    return {
+        name: serviceName,
+        priority: config.priority ?? DEFAULT_PRIORITY,
+        factory: async ({ app, logger }) => {
+            // --- Step 1: Load translations from all sources ---
+            const catalog = await loadAllSources(config.sources, logger);
+            // --- Step 2: Create Translator ---
+            const translator = new Translator({
+                defaultLocale,
+                catalog,
+                onMissingTranslation: config.onMissingTranslation,
+            });
+            await logger.info(`I18n plugin: loaded ${Object.keys(catalog).length} translation keys ` +
+                `from ${config.sources.length} source(s)`);
+            // --- Step 3: Register Translator as singleton service ---
+            app.registerService({
+                name: serviceName,
+                type: "singleton",
+                factory: () => translator,
+            });
+            // --- Step 4: Register per-request locale service ---
+            app.registerService({
+                name: localeServiceName,
+                type: "per-request",
+                factory: (_container, _settings, req, res) => {
+                    const locale = resolveLocale(req, defaultLocale, cookieName);
+                    // Persist locale in cookie (if configured)
+                    if (cookieName) {
+                        res.cookie(cookieName, locale, {
+                            httpOnly: false,
+                            sameSite: "lax",
+                            maxAge: 365 * 24 * 60 * 60 * 1000, // 1 year
+                        });
+                    }
+                    return locale;
+                },
+            });
+            // --- Step 5: Optional pub/sub reload ---
+            if (config.reloadChannel) {
+                const pubsubName = config.pubsubServiceName ?? DEFAULT_PUBSUB_SERVICE_NAME;
+                try {
+                    // Access service container via cast — services is protected on WebApplication
+                    // but plugins are trusted framework code that need service resolution
+                    const pubsub = await app.services.get(pubsubName);
+                    if (pubsub && typeof pubsub.subscribe === "function") {
+                        await pubsub.subscribe(config.reloadChannel, async () => {
+                            await logger.info(`I18n reload triggered via pub/sub`);
+                            await reloadSources(config.sources, translator, logger);
+                        });
+                        await logger.info(`I18n plugin: subscribed to reload channel "${config.reloadChannel}"`);
+                    }
+                }
+                catch {
+                    await logger.info(`I18n plugin: pub/sub service "${pubsubName}" not available — ` +
+                        `reload channel "${config.reloadChannel}" will not be active`);
+                }
+            }
+            await logger.info(`I18n plugin "${serviceName}" initialized`);
+            // --- Return Plugin hooks ---
+            return {
+                health: async () => true,
+            };
+        },
+    };
+}
+/**
+ * Load all translation sources and merge their catalogs.
+ *
+ * Sources are loaded in order. Later sources override earlier ones
+ * for the same key+locale pair.
+ *
+ * @param sources - Array of translation sources
+ * @param logger - Logger for progress messages
+ * @returns Merged translation catalog
+ */
+async function loadAllSources(sources, logger) {
+    const catalogs = [];
+    for (const source of sources) {
+        await logger.info(`I18n: loading from ${source.name}...`);
+        const catalog = await source.load();
+        await logger.info(`I18n: ${source.name} loaded ${Object.keys(catalog).length} keys`);
+        catalogs.push(catalog);
+    }
+    return mergeCatalogs(catalogs);
+}
+/**
+ * Reload all sources and atomically swap the translator's catalog.
+ *
+ * On failure, logs the error but keeps the old catalog (graceful degradation).
+ *
+ * @param sources - Array of translation sources
+ * @param translator - The Translator instance to update
+ * @param logger - Logger for progress messages
+ */
+async function reloadSources(sources, translator, logger) {
+    try {
+        const catalog = await loadAllSources(sources, logger);
+        translator.setCatalog(catalog);
+        await logger.info(`I18n: reload complete — ${Object.keys(catalog).length} keys loaded`);
+    }
+    catch (error) {
+        // Log the error but don't crash — keep the old catalog
+        await logger.error(`I18n: reload failed, keeping previous catalog: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=i18n-plugin.js.map

package/dist/webafx-i18n/i18n-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-plugin.js","sourceRoot":"","sources":["../src/i18n-plugin.ts"],"names":[],"mappings":"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"}

package/dist/webafx-i18n/index.d.ts

@@ -0,0 +1,12 @@
+export { createI18nPlugin } from "./i18n-plugin.js";
+export type { I18nPluginConfig } from "./types.js";
+export { PostgreSQLSource, postgresqlSource } from "./postgresql-source.js";
+export type { PostgreSQLSourceConfig } from "./postgresql-source.js";
+export { resolveLocale, parseAcceptLanguage } from "./locale-resolver.js";
+export { Translator, mergeCatalogs } from "../i18n/index.js";
+export type { TranslationCatalog, TranslationEntry, TranslationValue, TranslationSource, TranslatorConfig, } from "../i18n/index.js";
+export { JsonFileSource, jsonFileSource } from "../i18n/node.js";
+export type { JsonFileSourceConfig } from "../i18n/node.js";
+export { ContentFileSource, contentFileSource } from "../i18n/node.js";
+export type { ContentFileSourceConfig } from "../i18n/node.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/webafx-i18n/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpD,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAGrE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAG1E,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC3D,YAAY,EACR,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GACnB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrE,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,YAAY,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/webafx-i18n/index.js

@@ -0,0 +1,12 @@
+// Plugin
+export { createI18nPlugin } from "./i18n-plugin.js";
+// Sources
+export { PostgreSQLSource, postgresqlSource } from "./postgresql-source.js";
+// Locale resolver (exported for testing and custom use)
+export { resolveLocale, parseAcceptLanguage } from "./locale-resolver.js";
+// Re-export browser-safe i18n core for convenience
+export { Translator, mergeCatalogs } from "../i18n/index.js";
+// Re-export Node.js-only file sources from the /node subpath
+export { JsonFileSource, jsonFileSource } from "../i18n/node.js";
+export { ContentFileSource, contentFileSource } from "../i18n/node.js";
+//# sourceMappingURL=index.js.map

package/dist/webafx-i18n/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,SAAS;AACT,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAKpD,UAAU;AACV,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG5E,wDAAwD;AACxD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE1E,mDAAmD;AACnD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAS3D,6DAA6D;AAC7D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/webafx-i18n/locale-resolver.d.ts

@@ -0,0 +1,33 @@
+import type { Request } from "express";
+/**
+ * Resolve the locale for an incoming HTTP request.
+ *
+ * Resolution priority (first match wins):
+ * 1. Query parameter: `?locale=nl`
+ * 2. Accept-Language header: `Accept-Language: nl, en;q=0.8`
+ * 3. Cookie: `locale=nl` (cookie name configurable)
+ * 4. Default locale from config
+ *
+ * @param req - Express Request object
+ * @param defaultLocale - Fallback locale
+ * @param cookieName - Cookie name to check (false to skip)
+ * @returns The resolved locale string
+ *
+ * @example
+ * resolveLocale(req, "en", "locale") // → "nl" (if ?locale=nl)
+ */
+export declare function resolveLocale(req: Request, defaultLocale: string, cookieName: string | false): string;
+/**
+ * Parse the Accept-Language header and return the highest-priority locale.
+ *
+ * Handles formats like:
+ * - "nl" → "nl"
+ * - "nl, en;q=0.8" → "nl"
+ * - "en-US,en;q=0.9,nl;q=0.8" → "en_US" (normalized)
+ * - "*" → null (wildcard, use default)
+ *
+ * @param header - The Accept-Language header value
+ * @returns The best locale, or null if none can be determined
+ */
+export declare function parseAcceptLanguage(header: string): string | null;
+//# sourceMappingURL=locale-resolver.d.ts.map

package/dist/webafx-i18n/locale-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-resolver.d.ts","sourceRoot":"","sources":["../src/locale-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CACzB,GAAG,EAAE,OAAO,EACZ,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GAAG,KAAK,GAC3B,MAAM,CAuBR;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgBjE"}

package/dist/webafx-i18n/locale-resolver.js

@@ -0,0 +1,67 @@
+/**
+ * Resolve the locale for an incoming HTTP request.
+ *
+ * Resolution priority (first match wins):
+ * 1. Query parameter: `?locale=nl`
+ * 2. Accept-Language header: `Accept-Language: nl, en;q=0.8`
+ * 3. Cookie: `locale=nl` (cookie name configurable)
+ * 4. Default locale from config
+ *
+ * @param req - Express Request object
+ * @param defaultLocale - Fallback locale
+ * @param cookieName - Cookie name to check (false to skip)
+ * @returns The resolved locale string
+ *
+ * @example
+ * resolveLocale(req, "en", "locale") // → "nl" (if ?locale=nl)
+ */
+export function resolveLocale(req, defaultLocale, cookieName) {
+    // 1. Query parameter
+    const queryLocale = req.query?.locale;
+    if (typeof queryLocale === "string" && queryLocale.trim()) {
+        return queryLocale.trim();
+    }
+    // 2. Accept-Language header
+    const acceptLanguage = req.headers["accept-language"];
+    if (acceptLanguage) {
+        const parsed = parseAcceptLanguage(acceptLanguage);
+        if (parsed) {
+            return parsed;
+        }
+    }
+    // 3. Cookie
+    if (cookieName && req.cookies?.[cookieName]) {
+        return req.cookies[cookieName];
+    }
+    // 4. Default
+    return defaultLocale;
+}
+/**
+ * Parse the Accept-Language header and return the highest-priority locale.
+ *
+ * Handles formats like:
+ * - "nl" → "nl"
+ * - "nl, en;q=0.8" → "nl"
+ * - "en-US,en;q=0.9,nl;q=0.8" → "en_US" (normalized)
+ * - "*" → null (wildcard, use default)
+ *
+ * @param header - The Accept-Language header value
+ * @returns The best locale, or null if none can be determined
+ */
+export function parseAcceptLanguage(header) {
+    const entries = header
+        .split(",")
+        .map((entry) => {
+        const [locale, ...params] = entry.trim().split(";");
+        const qParam = params.find((p) => p.trim().startsWith("q="));
+        const quality = qParam ? parseFloat(qParam.trim().slice(2)) : 1.0;
+        return { locale: locale.trim(), quality };
+    })
+        .filter((e) => e.locale !== "*" && e.locale !== "" && e.quality > 0)
+        .sort((a, b) => b.quality - a.quality);
+    if (entries.length === 0)
+        return null;
+    // Normalize: "en-US" → "en_US"
+    return entries[0].locale.replace("-", "_");
+}
+//# sourceMappingURL=locale-resolver.js.map

package/dist/webafx-i18n/locale-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-resolver.js","sourceRoot":"","sources":["../src/locale-resolver.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,aAAa,CACzB,GAAY,EACZ,aAAqB,EACrB,UAA0B;IAE1B,qBAAqB;IACrB,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC;IACtC,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;QACxD,OAAO,WAAW,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,4BAA4B;IAC5B,MAAM,cAAc,GAAG,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACtD,IAAI,cAAc,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;QACnD,IAAI,MAAM,EAAE,CAAC;YACT,OAAO,MAAM,CAAC;QAClB,CAAC;IACL,CAAC;IAED,YAAY;IACZ,IAAI,UAAU,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1C,OAAO,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACnC,CAAC;IAED,aAAa;IACb,OAAO,aAAa,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAC9C,MAAM,OAAO,GAAG,MAAM;SACjB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACX,MAAM,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAClE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC;IAC9C,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,MAAM,KAAK,EAAE,IAAI,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC;SACnE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;IAE3C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEtC,+BAA+B;IAC/B,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAC/C,CAAC"}