@velajs/vela 1.18.0 → 1.19.1

package/dist/http/url/signed-url.guard.js

@@ -1,62 +0,0 @@
-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);
-    };
-}
-import { Injectable, Inject, Optional } from "../../container/decorators.js";
-import { CONFIG_ENV } from "../../config/config.tokens.js";
-import { verifySignedUrl } from "../../crypto/signed-url.js";
-import { ForbiddenException } from "../../errors/http-exception.js";
-import { applyDecorators } from "../decorators.js";
-import { UseGuards } from "../../pipeline/decorators.js";
-import { URL_SIGNING_SECRET, resolveSigningSecret } from "./signing-secret.js";
-export class SignedUrlGuard {
-    secretToken;
-    env;
-    constructor(secretToken, env = {}){
-        this.secretToken = secretToken;
-        this.env = env;
-    }
-    async canActivate(context) {
-        const request = context.switchToHttp().getRequest();
-        const secret = resolveSigningSecret(undefined, this.secretToken, this.env);
-        const valid = await verifySignedUrl(request.url, secret);
-        if (!valid) {
-            throw new ForbiddenException('Invalid or expired signed URL');
-        }
-        return true;
-    }
-}
-SignedUrlGuard = _ts_decorate([
-    Injectable(),
-    _ts_param(0, Optional()),
-    _ts_param(0, Inject(URL_SIGNING_SECRET)),
-    _ts_param(1, Optional()),
-    _ts_param(1, Inject(CONFIG_ENV)),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        String,
-        typeof Record === "undefined" ? Object : Record
-    ])
-], SignedUrlGuard);
-/**
- * Guards a route with {@link SignedUrlGuard} — the request must carry a valid,
- * unexpired HMAC signature (produced by `UrlGeneratorService.signedUrl`).
- *
- * ```ts
- * @Get('download', { name: 'file.download' })
- * @SignedUrl()
- * download() { ... }
- * ```
- */ export function SignedUrl() {
-    return applyDecorators(UseGuards(SignedUrlGuard));
-}

package/dist/http/url/signing-secret.d.ts

@@ -1,20 +0,0 @@
-import { InjectionToken } from '../../container/types';
-/**
- * Optional DI token holding the HMAC secret used to sign / verify URLs. Provide
- * it globally (e.g. from a platform adapter or a `@Global` module) so both
- * {@link UrlGeneratorService} and the signed-URL guard can read it:
- *
- * ```ts
- * { provide: URL_SIGNING_SECRET, useValue: env.URL_SIGNING_SECRET }
- * ```
- */
-export declare const URL_SIGNING_SECRET: InjectionToken<string>;
-/** Key read from `CONFIG_ENV` when no explicit secret / token is available. */
-export declare const URL_SIGNING_SECRET_ENV_KEY = "URL_SIGNING_SECRET";
-/**
- * Resolve the signing secret from, in order: an explicit argument, the
- * {@link URL_SIGNING_SECRET} token, then `CONFIG_ENV[URL_SIGNING_SECRET]`.
- * Throws a descriptive error when none is available — signing must never fall
- * back to an empty/implicit key.
- */
-export declare function resolveSigningSecret(explicit: string | undefined, token: string | undefined, env: Record<string, unknown> | undefined): string;

package/dist/http/url/signing-secret.js

@@ -1,24 +0,0 @@
-import { InjectionToken } from "../../container/types.js";
-/**
- * Optional DI token holding the HMAC secret used to sign / verify URLs. Provide
- * it globally (e.g. from a platform adapter or a `@Global` module) so both
- * {@link UrlGeneratorService} and the signed-URL guard can read it:
- *
- * ```ts
- * { provide: URL_SIGNING_SECRET, useValue: env.URL_SIGNING_SECRET }
- * ```
- */ export const URL_SIGNING_SECRET = new InjectionToken('URL_SIGNING_SECRET');
-/** Key read from `CONFIG_ENV` when no explicit secret / token is available. */ export const URL_SIGNING_SECRET_ENV_KEY = 'URL_SIGNING_SECRET';
-/**
- * Resolve the signing secret from, in order: an explicit argument, the
- * {@link URL_SIGNING_SECRET} token, then `CONFIG_ENV[URL_SIGNING_SECRET]`.
- * Throws a descriptive error when none is available — signing must never fall
- * back to an empty/implicit key.
- */ export function resolveSigningSecret(explicit, token, env) {
-    const fromEnv = env?.[URL_SIGNING_SECRET_ENV_KEY];
-    const secret = explicit ?? token ?? (typeof fromEnv === 'string' ? fromEnv : undefined);
-    if (!secret) {
-        throw new Error('No URL signing secret is available. Pass one explicitly, register a ' + '`URL_SIGNING_SECRET` provider, or set `URL_SIGNING_SECRET` in `CONFIG_ENV`.');
-    }
-    return secret;
-}

package/dist/http/url/url-generator.service.d.ts

@@ -1,52 +0,0 @@
-import { RouteManager } from '../route.manager';
-import type { RouteName, RouteParams } from '../route-map';
-/** Value accepted for a path param or query entry. */
-type UrlParamValue = string | number | boolean;
-/** Extra options for {@link UrlGeneratorService.urlFor}. */
-export interface UrlForOptions {
-    /** Additional query-string entries merged after any leftover params. */
-    query?: Record<string, UrlParamValue>;
-}
-/** Options for {@link UrlGeneratorService.signedUrl}. */
-export interface SignedUrlGenerateOptions {
-    /** Time-to-live in seconds; enforced on verification via the `expires` param. */
-    expiresIn?: number;
-    /** Override the signing secret (else the `URL_SIGNING_SECRET` token / `CONFIG_ENV`). */
-    secret?: string;
-}
-/**
- * Builds URLs for named routes (Laravel-flavoured `route()` ergonomics).
- *
- * Route descriptions are read LAZILY from the {@link RouteManager} on first use
- * — post-build, so composition (global prefix + version + controller prefix) is
- * already baked into each path — and it never instantiates controllers, so it
- * plays nicely with lazy modules. Registered as an app-level singleton by
- * `bootstrap`, so it is injectable anywhere.
- */
-export declare class UrlGeneratorService {
-    private readonly routeManager;
-    private readonly secretToken?;
-    private readonly env;
-    private routeMap;
-    constructor(routeManager: RouteManager, secretToken?: string | undefined, env?: Record<string, unknown>);
-    /**
-     * Build the path for a named route, filling `:param` placeholders from
-     * `params`. Params that don't match a placeholder become query-string
-     * entries; `opts.query` is merged after them.
-     *
-     * @throws if no route carries `name`, or a required `:param` is missing.
-     */
-    urlFor<N extends RouteName>(name: N, params?: RouteParams<N>, opts?: UrlForOptions): string;
-    /**
-     * Build a named-route URL and HMAC-sign it (path + query). The secret comes
-     * from `options.secret`, else the {@link URL_SIGNING_SECRET} token, else
-     * `CONFIG_ENV`; a descriptive error is thrown when none is available.
-     */
-    signedUrl<N extends RouteName>(name: N, params?: RouteParams<N>, options?: SignedUrlGenerateOptions): Promise<string>;
-    /**
-     * Lazily index named route descriptions. Rebuilt while empty (routes may not
-     * be built yet), cached once populated.
-     */
-    private routes;
-}
-export {};

package/dist/http/url/url-generator.service.js

@@ -1,104 +0,0 @@
-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);
-    };
-}
-import { Injectable, Inject, Optional } from "../../container/decorators.js";
-import { CONFIG_ENV } from "../../config/config.tokens.js";
-import { signUrl } from "../../crypto/signed-url.js";
-import { RouteManager } from "../route.manager.js";
-import { URL_SIGNING_SECRET, resolveSigningSecret } from "./signing-secret.js";
-export class UrlGeneratorService {
-    routeManager;
-    secretToken;
-    env;
-    routeMap = null;
-    constructor(routeManager, secretToken, env = {}){
-        this.routeManager = routeManager;
-        this.secretToken = secretToken;
-        this.env = env;
-    }
-    /**
-   * Build the path for a named route, filling `:param` placeholders from
-   * `params`. Params that don't match a placeholder become query-string
-   * entries; `opts.query` is merged after them.
-   *
-   * @throws if no route carries `name`, or a required `:param` is missing.
-   */ urlFor(name, params, opts) {
-        const description = this.routes().get(name);
-        if (!description) {
-            throw new Error(`No route named "${String(name)}" was found. Give the route a name ` + `via \`@Get(path, { name: '${String(name)}' })\`.`);
-        }
-        const provided = {
-            ...params ?? {}
-        };
-        const consumed = new Set();
-        const path = description.path.replace(/:([A-Za-z0-9_]+)/g, (_match, key)=>{
-            const value = provided[key];
-            if (value === undefined || value === null) {
-                throw new Error(`Missing route param "${key}" for route "${String(name)}".`);
-            }
-            consumed.add(key);
-            return encodeURIComponent(String(value));
-        });
-        const query = new URLSearchParams();
-        for (const [key, value] of Object.entries(provided)){
-            if (consumed.has(key) || value === undefined || value === null) continue;
-            query.set(key, String(value));
-        }
-        for (const [key, value] of Object.entries(opts?.query ?? {})){
-            if (value === undefined || value === null) continue;
-            query.set(key, String(value));
-        }
-        const qs = query.toString();
-        return qs ? `${path}?${qs}` : path;
-    }
-    /**
-   * Build a named-route URL and HMAC-sign it (path + query). The secret comes
-   * from `options.secret`, else the {@link URL_SIGNING_SECRET} token, else
-   * `CONFIG_ENV`; a descriptive error is thrown when none is available.
-   */ async signedUrl(name, params, options = {}) {
-        const url = this.urlFor(name, params);
-        const secret = resolveSigningSecret(options.secret, this.secretToken, this.env);
-        return signUrl(url, secret, options.expiresIn !== undefined ? {
-            expiresIn: options.expiresIn
-        } : undefined);
-    }
-    /**
-   * Lazily index named route descriptions. Rebuilt while empty (routes may not
-   * be built yet), cached once populated.
-   */ routes() {
-        if (this.routeMap && this.routeMap.size > 0) return this.routeMap;
-        const map = new Map();
-        for (const description of this.routeManager.getRouteDescriptions()){
-            if (description.name && !map.has(description.name)) {
-                map.set(description.name, description);
-            }
-        }
-        this.routeMap = map;
-        return map;
-    }
-}
-UrlGeneratorService = _ts_decorate([
-    Injectable(),
-    _ts_param(0, Inject(RouteManager)),
-    _ts_param(1, Optional()),
-    _ts_param(1, Inject(URL_SIGNING_SECRET)),
-    _ts_param(2, Optional()),
-    _ts_param(2, Inject(CONFIG_ENV)),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof RouteManager === "undefined" ? Object : RouteManager,
-        String,
-        typeof Record === "undefined" ? Object : Record
-    ])
-], UrlGeneratorService);

package/dist/i18n/deep-merge.d.ts

@@ -1,2 +0,0 @@
-/** Deep-merge two message trees; source overrides target at the leaf level. */
-export declare function deepMerge(target: Record<string, unknown>, source: Record<string, unknown>): Record<string, unknown>;

package/dist/i18n/deep-merge.js

@@ -1,15 +0,0 @@
-/** Deep-merge two message trees; source overrides target at the leaf level. */ export function deepMerge(target, source) {
-    const result = {
-        ...target
-    };
-    for (const key of Object.keys(source)){
-        const targetValue = target[key];
-        const sourceValue = source[key];
-        if (typeof targetValue === 'object' && targetValue !== null && !Array.isArray(targetValue) && typeof sourceValue === 'object' && sourceValue !== null && !Array.isArray(sourceValue)) {
-            result[key] = deepMerge(targetValue, sourceValue);
-        } else {
-            result[key] = sourceValue;
-        }
-    }
-    return result;
-}

package/dist/i18n/i18n.middleware.d.ts

@@ -1,15 +0,0 @@
-import type { Context, Next } from 'hono';
-import type { NestMiddleware } from '../pipeline/types';
-import { type I18nModuleOptions } from './i18n.options';
-/**
- * Detects the request locale and stashes it on the per-request RequestContext
- * bag under {@link I18N_LOCALE_KEY}, where {@link I18nService} reads it.
- * Registered globally via APP_MIDDLEWARE by {@link I18nModule}. Holds no
- * per-request state (reads the RequestContext off the request container each
- * call), so a singleton instance is safe.
- */
-export declare class I18nLocaleMiddleware implements NestMiddleware {
-    private readonly resolved;
-    constructor(options: I18nModuleOptions);
-    use(c: Context, next: Next): Promise<Response | void>;
-}

package/dist/i18n/i18n.middleware.js

@@ -1,94 +0,0 @@
-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);
-    };
-}
-import { Inject, Injectable } from "../container/decorators.js";
-import { REQUEST_CONTEXT } from "../http/request-context.js";
-import { resolveI18nOptions } from "./i18n.options.js";
-import { I18N_LOCALE_KEY, I18N_OPTIONS } from "./i18n.tokens.js";
-export class I18nLocaleMiddleware {
-    resolved;
-    constructor(options){
-        this.resolved = resolveI18nOptions(options);
-    }
-    async use(c, next) {
-        const container = c.get('container');
-        if (container) {
-            const ctx = container.resolve(REQUEST_CONTEXT);
-            ctx.set(I18N_LOCALE_KEY, detectLocale(c, this.resolved));
-        }
-        return next();
-    }
-}
-I18nLocaleMiddleware = _ts_decorate([
-    Injectable(),
-    _ts_param(0, Inject(I18N_OPTIONS)),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof I18nModuleOptions === "undefined" ? Object : I18nModuleOptions
-    ])
-], I18nLocaleMiddleware);
-function detectLocale(c, resolved) {
-    if (!resolved.detection.enabled) return resolved.defaultLocale;
-    const { strategy, lookupKey } = resolved.detection;
-    // Candidate tags in preference order.
-    const candidates = strategy === 'query' ? [
-        new URL(c.req.url).searchParams.get(lookupKey) ?? ''
-    ] : strategy === 'cookie' ? [
-        readCookie(c.req.raw.headers.get('cookie'), lookupKey) ?? ''
-    ] : parseAcceptLanguage(c.req.raw.headers.get('accept-language'));
-    for (const candidate of candidates){
-        const match = matchLocale(candidate, resolved.locales);
-        if (match) return match;
-    }
-    return resolved.defaultLocale;
-}
-/** Case-insensitive locale match with region fallback (en-US -> en); returns the configured casing. */ function matchLocale(candidate, locales) {
-    if (!candidate) return undefined;
-    const lc = candidate.toLowerCase();
-    const exact = locales.find((l)=>l.toLowerCase() === lc);
-    if (exact) return exact;
-    const base = lc.split('-')[0];
-    return locales.find((l)=>l.toLowerCase().split('-')[0] === base);
-}
-/** Parse Accept-Language into tags ordered by descending q-value (RFC 7231). */ function parseAcceptLanguage(header) {
-    if (!header) return [];
-    return header.split(',').map((part)=>{
-        const [tag, ...params] = part.trim().split(';');
-        let q = 1;
-        for (const p of params){
-            const m = p.trim().match(/^q=([\d.]+)$/);
-            if (m) q = Number.parseFloat(m[1]);
-        }
-        return {
-            tag: (tag ?? '').trim(),
-            q: Number.isNaN(q) ? 0 : q
-        };
-    }).filter((e)=>e.tag && e.tag !== '*').sort((a, b)=>b.q - a.q).map((e)=>e.tag);
-}
-function readCookie(header, name) {
-    if (!header) return undefined;
-    for (const part of header.split(';')){
-        const [rawKey, ...rest] = part.split('=');
-        if (rawKey?.trim() === name) {
-            const raw = rest.join('=').trim();
-            try {
-                return decodeURIComponent(raw);
-            } catch  {
-                // Malformed percent-encoding must not crash locale detection.
-                return raw;
-            }
-        }
-    }
-    return undefined;
-}

package/dist/i18n/i18n.module.d.ts

@@ -1,13 +0,0 @@
-import type { DynamicModule } from '../module/types';
-import type { I18nModuleOptions } from './i18n.options';
-declare const ConfigurableModuleClass: import("..").ConfigurableModuleClassType<I18nModuleOptions, "forRoot", "create", {
-    isGlobal?: boolean;
-}>;
-export declare class I18nModule extends ConfigurableModuleClass {
-    /**
-     * forFeature-style: contribute a message tree (`{ [locale]: { ...messages } }`).
-     * Contributions are collected statically at module-load and deep-merged.
-     */
-    static registerMessages(messages: Record<string, Record<string, unknown>>): DynamicModule;
-}
-export {};

package/dist/i18n/i18n.module.js

@@ -1,69 +0,0 @@
-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;
-}
-import { Module } from "../module/decorators.js";
-import { ConfigurableModuleBuilder } from "../module/configurable-module.builder.js";
-import { stableHash } from "../module/stable-hash.js";
-import { APP_MIDDLEWARE } from "../pipeline/tokens.js";
-import { I18nLocaleMiddleware } from "./i18n.middleware.js";
-import { I18nService } from "./i18n.service.js";
-import { I18N_OPTIONS } from "./i18n.tokens.js";
-import { MessageLoaderService } from "./message-loader.service.js";
-import { MessageRegistry } from "./message-registry.js";
-const { ConfigurableModuleClass } = new ConfigurableModuleBuilder({
-    moduleName: 'I18n',
-    optionsInjectionToken: I18N_OPTIONS
-}).build();
-// Empty marker module for `registerMessages`. The contribution is a side-effect
-// on the global MessageRegistry; this carries NO providers so it never
-// duplicates I18nModule's providers (which would trip vela's multi-instance
-// encapsulation → MultipleProvidersFoundError). New modules whose contribution
-// is providers (not an external registry) should use `sideEffectModule` from
-// the authoring kit; this predates it and keeps a shared-class identity so
-// identical message trees dedup as one module instance.
-let I18nMessagesModule = class I18nMessagesModule {
-};
-I18nMessagesModule = _ts_decorate([
-    Module({})
-], I18nMessagesModule);
-export class I18nModule extends ConfigurableModuleClass {
-    /**
-   * forFeature-style: contribute a message tree (`{ [locale]: { ...messages } }`).
-   * Contributions are collected statically at module-load and deep-merged.
-   */ static registerMessages(messages) {
-        MessageRegistry.addMessages(messages);
-        return {
-            module: I18nMessagesModule,
-            key: `messages:${stableHash(messages)}`,
-            providers: []
-        };
-    }
-}
-I18nModule = _ts_decorate([
-    Module({
-        // Lazy: the merged-message snapshot (MessageLoaderService constructor) and
-        // locale middleware materialize on the first request that reaches them —
-        // message registration itself is import-time and unaffected. Safe because
-        // the route-build priority probe skips lazy-pending APP_MIDDLEWARE tokens.
-        lazy: true,
-        providers: [
-            MessageRegistry,
-            MessageLoaderService,
-            I18nService,
-            I18nLocaleMiddleware,
-            // Register the locale middleware globally (NestJS APP_MIDDLEWARE convention).
-            {
-                provide: APP_MIDDLEWARE,
-                useExisting: I18nLocaleMiddleware
-            }
-        ],
-        exports: [
-            I18nService,
-            MessageLoaderService,
-            I18N_OPTIONS
-        ]
-    })
-], I18nModule);

package/dist/i18n/i18n.options.d.ts

@@ -1,30 +0,0 @@
-/** How the request locale is detected. */
-export type DetectionStrategy = 'header' | 'query' | 'cookie';
-export interface I18nModuleOptions {
-    /** Default locale. @default 'en' */
-    defaultLocale?: string;
-    /** Fallback when a translation is missing. @default defaultLocale */
-    fallbackLocale?: string;
-    /** Supported locales; request locales outside this list fall back to default. @default ['en'] */
-    locales?: string[];
-    /** Locale detection config. */
-    detection?: {
-        /** Set false to disable detection (always use defaultLocale). @default true */
-        enabled?: boolean;
-        /** @default 'header' (Accept-Language) */
-        strategy?: DetectionStrategy;
-        /** Cookie/query parameter name. @default 'locale' */
-        lookupKey?: string;
-    };
-}
-export interface ResolvedI18nOptions {
-    defaultLocale: string;
-    fallbackLocale: string;
-    locales: string[];
-    detection: {
-        enabled: boolean;
-        strategy: DetectionStrategy;
-        lookupKey: string;
-    };
-}
-export declare function resolveI18nOptions(options?: I18nModuleOptions): ResolvedI18nOptions;

package/dist/i18n/i18n.options.js

@@ -1,16 +0,0 @@
-/** How the request locale is detected. */ export function resolveI18nOptions(options) {
-    const detection = options?.detection;
-    const defaultLocale = options?.defaultLocale ?? 'en';
-    return {
-        defaultLocale,
-        fallbackLocale: options?.fallbackLocale ?? defaultLocale,
-        locales: options?.locales ?? [
-            'en'
-        ],
-        detection: {
-            enabled: detection?.enabled !== false,
-            strategy: detection?.strategy ?? 'header',
-            lookupKey: detection?.lookupKey ?? 'locale'
-        }
-    };
-}

package/dist/i18n/i18n.service.d.ts

@@ -1,20 +0,0 @@
-import { type RequestContext } from '../http/request-context';
-import type { I18nModuleOptions } from './i18n.options';
-import type { II18nService } from './i18n.types';
-import { MessageLoaderService } from './message-loader.service';
-/**
- * Request-scoped translation facade. Reads the locale resolved by
- * {@link I18nLocaleMiddleware} from the per-request RequestContext.
- *
- * Injecting it into a controller/service is safe: vela's request-scope bubbling
- * promotes the consumer to request scope automatically, so no captive-dependency
- * hazard and no `ambientContainer` flag required.
- */
-export declare class I18nService implements II18nService {
-    private readonly loader;
-    private readonly ctx;
-    private readonly options;
-    constructor(loader: MessageLoaderService, ctx: RequestContext, options: I18nModuleOptions);
-    t(key: string, params?: Record<string, unknown>): string;
-    getLocale(): string;
-}

package/dist/i18n/i18n.service.js

@@ -1,49 +0,0 @@
-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);
-    };
-}
-import { Scope } from "../constants.js";
-import { Inject, Injectable } from "../container/decorators.js";
-import { REQUEST_CONTEXT } from "../http/request-context.js";
-import { I18N_LOCALE_KEY, I18N_OPTIONS } from "./i18n.tokens.js";
-import { MessageLoaderService } from "./message-loader.service.js";
-export class I18nService {
-    loader;
-    ctx;
-    options;
-    constructor(loader, ctx, options){
-        this.loader = loader;
-        this.ctx = ctx;
-        this.options = options;
-    }
-    t(key, params) {
-        return this.loader.translate(this.getLocale(), key, params);
-    }
-    getLocale() {
-        return this.ctx.get(I18N_LOCALE_KEY) ?? this.options.defaultLocale ?? 'en';
-    }
-}
-I18nService = _ts_decorate([
-    Injectable({
-        scope: Scope.REQUEST
-    }),
-    _ts_param(0, Inject(MessageLoaderService)),
-    _ts_param(1, Inject(REQUEST_CONTEXT)),
-    _ts_param(2, Inject(I18N_OPTIONS)),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof MessageLoaderService === "undefined" ? Object : MessageLoaderService,
-        typeof RequestContext === "undefined" ? Object : RequestContext,
-        typeof I18nModuleOptions === "undefined" ? Object : I18nModuleOptions
-    ])
-], I18nService);

package/dist/i18n/i18n.tokens.d.ts

@@ -1,6 +0,0 @@
-import { InjectionToken } from '../container/types';
-import type { I18nModuleOptions } from './i18n.options';
-/** Options bag from `I18nModule.forRoot()` (the ConfigurableModuleBuilder options token). */
-export declare const I18N_OPTIONS: InjectionToken<I18nModuleOptions>;
-/** Key under which the resolved locale is stashed on the per-request RequestContext bag. */
-export declare const I18N_LOCALE_KEY: unique symbol;

package/dist/i18n/i18n.tokens.js

@@ -1,3 +0,0 @@
-import { InjectionToken } from "../container/types.js";
-/** Options bag from `I18nModule.forRoot()` (the ConfigurableModuleBuilder options token). */ export const I18N_OPTIONS = new InjectionToken('I18N_OPTIONS');
-/** Key under which the resolved locale is stashed on the per-request RequestContext bag. */ export const I18N_LOCALE_KEY = Symbol.for('vela:i18n:locale');

package/dist/i18n/i18n.types.d.ts

@@ -1,6 +0,0 @@
-export interface II18nService {
-    /** Translate `key` (dot-path into the message tree) with optional ICU params. */
-    t(key: string, params?: Record<string, unknown>): string;
-    /** The resolved locale for the current request. */
-    getLocale(): string;
-}

package/dist/i18n/i18n.types.js

@@ -1 +0,0 @@
-export { };

package/dist/i18n/message-loader.service.d.ts

@@ -1,21 +0,0 @@
-import type { I18nModuleOptions } from './i18n.options';
-import { MessageRegistry } from './message-registry';
-/**
- * Compiles and caches ICU messages (via `intl-messageformat`). Singleton: reads
- * the merged registry once at construction (all `registerMessages` calls run at
- * module-load, before providers are instantiated), flattens each locale to
- * dot-paths, and compiles lazily per locale.
- */
-export declare class MessageLoaderService {
-    private readonly cache;
-    private readonly compiledCache;
-    private readonly defaultLocale;
-    private readonly fallbackLocale;
-    constructor(registry: MessageRegistry, options: I18nModuleOptions);
-    translate(locale: string, key: string, params?: Record<string, unknown>): string;
-    getAvailableLocales(): string[];
-    isLocaleSupported(locale: string): boolean;
-    getDefaultLocale(): string;
-    private getCompiledMessages;
-    private flattenMessages;
-}