mega-framework 0.1.6 → 0.1.8

package/types/core/hub-link.d.ts

@@ -0,0 +1,266 @@
+export class MegaHubLink {
+    /**
+     * 링크 라이프사이클 이벤트 (wire 타입과 충돌하지 않도록 `link.*` reserved). {@link MegaHubLink#on}
+     * 으로 구독한다. **핸들러 인자는 이벤트마다 다르다**(L-2):
+     *   - `RECONNECTED`     → `{ hubId: string }` — 재연결 성공(새 등록 완료). hubId 는 새 hub 의 식별자.
+     *   - `DISCONNECTED`    → `{ code: number, reason: string, isDrain: boolean }` — 등록 후 절단.
+     *     `isDrain` 은 close code 가 4503(DRAIN)인지(다른 hub 로 회전 신호, ADR-098).
+     *   - `RECONNECT_FAILED`→ `{ error: Error }` — 재연결 재시도 소진(더 이상 자동 재시도 없음).
+     * @type {Readonly<{ RECONNECTED: string, DISCONNECTED: string, RECONNECT_FAILED: string }>}
+     */
+    static EVENTS: Readonly<{
+        RECONNECTED: string;
+        DISCONNECTED: string;
+        RECONNECT_FAILED: string;
+    }>;
+    /**
+     * @param {Object} [opts]
+     * @param {string} [opts.url] - hub URL (예: 'ws://hub1.internal:19991/_hub'). 누락 시 throw.
+     * @param {string} [opts.token] - Bearer 토큰 (wsHub.acceptedTokens 중 하나). 누락 시 throw.
+     * @param {string} [opts.bridgeId] - 운영 식별자 (예: 'main-1'). 누락 시 throw.
+     * @param {string} [opts.instanceId] - REGISTER instanceId. 기본 bridgeId.
+     * @param {string[]} [opts.capabilities] - 선언 capability 목록. 기본 [].
+     * @param {import('../lib/mega-retry.js').MegaRetryOptions} [opts.retry] - 지정 시 재연결 활성(ADR-098).
+     *   `{ retries, minTimeout, maxTimeout, factor, jitter }`. 미지정 → 재연결 끔(기본 동작).
+     * @param {number} [opts.connectTimeoutMs=10000] - register_ok 미수신 시 attempt reject 까지(M4).
+     * @param {import('./ws-compression.js').WsCompressionConfig} [opts.compression] - Bridge↔Hub link
+     *   per-message deflate 압축(ADR-078). Global `wsHub.compression` 블록과 동일
+     *   스키마 — hub 서버와 양쪽이 협상해야 활성(RFC 7692). 디폴트 OFF. 잘못된 값은 즉시 throw.
+     * @param {{ warn?: Function, debug?: Function, info?: Function, error?: Function }} [opts.logger]
+     * @param {typeof import('ws').WebSocket} [opts.WebSocketCtor] - 테스트 주입용 ws 생성자.
+     * @param {number} [opts.maxBufferedBytes=16777216] - 송신 버퍼(bufferedAmount) 상한(바이트). 초과 시
+     *   백프레셔로 보고 소켓을 닫고(1013) 송신을 명시 실패시킨다 — hub 가 느릴 때 bridge 힙이 무한
+     *   적재되는 것을 막는다. 재연결(retry) 설정 시 자동 회복.
+     */
+    constructor({ url, token, bridgeId, instanceId, capabilities, retry, connectTimeoutMs, compression, logger, WebSocketCtor, maxBufferedBytes }?: {
+        url?: string;
+        token?: string;
+        bridgeId?: string;
+        instanceId?: string;
+        capabilities?: string[];
+        retry?: import("../lib/mega-retry.js").MegaRetryOptions;
+        connectTimeoutMs?: number;
+        compression?: import("./ws-compression.js").WsCompressionConfig;
+        logger?: {
+            warn?: Function;
+            debug?: Function;
+            info?: Function;
+            error?: Function;
+        };
+        WebSocketCtor?: typeof import("ws").WebSocket;
+        maxBufferedBytes?: number;
+    });
+    _url: string;
+    _token: string;
+    _bridgeId: string;
+    _instanceId: string;
+    _capabilities: string[];
+    _log: {
+        warn?: Function;
+        debug?: Function;
+        info?: Function;
+        error?: Function;
+    };
+    _WS: typeof WebSocket;
+    /** 재연결 옵션 (없으면 재연결 비활성). @type {import('../lib/mega-retry.js').MegaRetryOptions | null} */
+    _retry: import("../lib/mega-retry.js").MegaRetryOptions | null;
+    /** 한 attempt 의 register_ok 대기 한도(M4). reconnect 에서도 동일 적용. @type {number} */
+    _connectTimeoutMs: number;
+    /** 송신 버퍼(bufferedAmount) 상한 — 초과 시 백프레셔로 소켓을 닫는다(기본 16 MiB). @type {number} */
+    _maxBufferedBytes: number;
+    /** @type {false | Object} ws 클라이언트 perMessageDeflate 로 전달(_connectOnce). */
+    _perMessageDeflate: false | Object;
+    /** @type {import('ws').WebSocket | null} */
+    _ws: import("ws").WebSocket | null;
+    /** @type {boolean} register_ok 수신 여부. */
+    _isRegistered: boolean;
+    /** @type {string | null} hub 가 부여한 hubId. */
+    _hubId: string | null;
+    /** @type {number} register_ok 의 heartbeatMs(0 이면 heartbeat 끔). */
+    _heartbeatMs: number;
+    /** @type {ReturnType<typeof setInterval> | null} */
+    _hbTimer: ReturnType<typeof setInterval> | null;
+    /** type(wire)/lifecycle event → 핸들러 집합. @type {Map<string, Set<Function>>} */
+    _handlers: Map<string, Set<Function>>;
+    /** close() 로 의도적으로 닫는 중인지 — true 면 자동 재연결하지 않는다. @type {boolean} */
+    _isClosing: boolean;
+    /** 재연결 진행 중 가드(중복 reconnect 방지). @type {boolean} */
+    _isReconnecting: boolean;
+    /** close() 가 진행 중인 재시도(백오프 대기)를 취소하기 위한 컨트롤러. @type {AbortController | null} */
+    _abort: AbortController | null;
+    /** register_ok 로 협상된 hub 프로토콜 버전(등록 전 null, 레거시 hub 면 1). @type {number | null} */
+    _negotiatedProtocolVersion: number | null;
+    /**
+     * 레거시 hub 모드 — REGISTER 의 `protocolVersion` 필드를 모르는 구버전 hub(strict 스키마가
+     * `hub.invalid_message` 로 거부)로 판정되면 true. 이후 register 는 필드 없이(v1) 보낸다.
+     * @type {boolean}
+     */
+    _isLegacyHub: boolean;
+    /** hub 가 부여한 hubId (register 전엔 null). */
+    get hubId(): string;
+    /** register_ok 를 받아 사용 가능한 상태인지. */
+    get isRegistered(): boolean;
+    /** 협상된 hub 프로토콜 버전 (register 전엔 null, 레거시 hub 면 1). */
+    get negotiatedProtocolVersion(): number;
+    /** 소켓이 OPEN(=1) 인지. */
+    get isOpen(): boolean;
+    /** 재연결이 활성(retry 옵션 지정)인지. */
+    get canReconnect(): boolean;
+    /**
+     * 수신 메시지/라이프사이클 핸들러 등록. 같은 type 에 여러 개 등록 가능(모두 호출).
+     * @param {string} wireType - {@link HUB_MESSAGE_TYPES} 의 값(`hub.broadcast` 등) 또는
+     *   {@link MegaHubLink.EVENTS} 의 라이프사이클 이벤트(`link.*`).
+     * @param {(msg: Object) => void} handler
+     * @returns {this}
+     */
+    on(wireType: string, handler: (msg: Object) => void): this;
+    /**
+     * hub 연결 + REGISTER 핸드셰이크. register_ok 수신 시 resolve.
+     *
+     * 초기 연결은 retry 유무와 무관하게 **단 1회** 시도한다. `retry` 옵션이 있으면 실패 시 백그라운드
+     * 재연결(지수 백오프)로 전환하고 reject 한다 — 성공 시 RECONNECTED, 소진 시 RECONNECT_FAILED emit.
+     * 호출부(boot)는 reject 를 warn 으로 받고 부팅을 계속한다(허브 다운이 부팅을 막지 않는 계약).
+     *
+     * @param {Object} [opts]
+     * @param {number} [opts.connectTimeoutMs] - register_ok 대기 한도 override(M4). **이 값은 인스턴스에
+     *   저장되어(`this._connectTimeoutMs`) 이후 자동 재연결 attempt 에도 동일하게 적용된다** — 이 한 번의
+     *   connect() 에만 적용되는 것이 아니다(L-1). 재연결마다 같은 타임아웃을 쓰는 동작은 의도된 것이다.
+     * @returns {Promise<{ hubId: string, heartbeatMs: number }>}
+     * @throws register 전 에러/종료/타임아웃(재시도 소진 포함) 시 reject.
+     */
+    connect({ connectTimeoutMs }?: {
+        connectTimeoutMs?: number;
+    }): Promise<{
+        hubId: string;
+        heartbeatMs: number;
+    }>;
+    /**
+     * 단일 연결 시도 — ws open → REGISTER → register_ok. 한 attempt 의 Promise 를 돌려준다.
+     * 재시도/재연결은 호출부({@link MegaHubLink#connect}/{@link MegaHubLink#_reconnect})가 감싼다.
+     *
+     * @param {{ connectTimeoutMs: number }} args
+     * @returns {Promise<{ hubId: string, heartbeatMs: number }>}
+     * @private
+     */
+    private _connectOnce;
+    /**
+     * 등록 후 연결이 끊겼을 때 처리 — DISCONNECTED emit + (retry 활성·의도적 close 아님) 자동 재연결.
+     * @param {number} code - WS close code (4503=drain 등).
+     * @param {string} reason
+     * @private
+     */
+    private _handleEstablishedClose;
+    /**
+     * 자동 재연결 — 백오프로 _connectOnce 반복. 성공 시 RECONNECTED, 소진 시 RECONNECT_FAILED emit.
+     * @returns {Promise<void>}
+     * @private
+     */
+    private _reconnect;
+    /**
+     * 사용자 접속 알림 (JOIN). presence 등록.
+     * @param {{ userId: string, sessionId: string, channels: string[], metadata?: Object }} entry
+     * @returns {void}
+     */
+    join(entry: {
+        userId: string;
+        sessionId: string;
+        channels: string[];
+        metadata?: Object;
+    }): void;
+    /**
+     * 단일 세션 종료 (LEAVE).
+     * @param {string} sessionId
+     * @returns {void}
+     */
+    leave(sessionId: string): void;
+    /**
+     * 다수 세션 일괄 종료 (BULK_LEAVE) — 여러 세션의 presence LEAVE 를 한 프레임으로 보낸다.
+     *
+     * 공개 API 다(프레임워크 내부는 현재 hub 의 bridge-gone 자동 감지에 의존해 직접 호출하지 않음).
+     * 다음 같은 **대량 정리** 상황에서 애플리케이션이 직접 호출한다:
+     *   - 대량 logout(한 사용자의 여러 세션을 한 번에 종료),
+     *   - 클라이언트 풀/탭 정리(연결 다수를 묶어 종료),
+     *   - bridge 가 자체 drain 으로 보유 세션을 능동적으로 비울 때(소켓 close 를 기다리지 않고 선통지).
+     * 세션 1건이면 {@link MegaHubLink#leave} 를 쓰는 편이 단순하다.
+     *
+     * @param {string[]} sessionIds
+     * @returns {void}
+     */
+    bulkLeave(sessionIds: string[]): void;
+    /**
+     * 채널 전체 푸시 (BROADCAST). hub 가 가입 bridge 들에 fan-out.
+     * @param {{ ns: string, channel: string, message: Object, exceptSessionIds?: string[] }} payload
+     * @returns {void}
+     */
+    broadcast(payload: {
+        ns: string;
+        channel: string;
+        message: Object;
+        exceptSessionIds?: string[];
+    }): void;
+    /**
+     * 특정 사용자에게 직접 (DIRECT). hub 가 userId→sessionIds[] fan-out (ADR-035).
+     * @param {{ userId: string, message: Object }} payload
+     * @returns {void}
+     */
+    direct(payload: {
+        userId: string;
+        message: Object;
+    }): void;
+    /**
+     * 세션 메타데이터 갱신 (METADATA) — 명시 필드만(ADR-059).
+     * @param {{ sessionId: string, metadata: Object }} payload
+     * @returns {void}
+     */
+    updateMetadata(payload: {
+        sessionId: string;
+        metadata: Object;
+    }): void;
+    /**
+     * 바이너리 메타 프레임 (BINARY). raw bytes 후속 프레임 전송은 본 Step 미포함(envelope 한정).
+     * @param {{ ref: string, mimeType: string, bytes: number }} payload
+     * @returns {void}
+     */
+    binary(payload: {
+        ref: string;
+        mimeType: string;
+        bytes: number;
+    }): void;
+    /** 연결 종료 — 의도적 close 표시 + 진행 중 재연결 취소 + heartbeat 정리 후 소켓 close. */
+    close(): void;
+    /**
+     * 타입별 송신 — register_ok 이후에만 허용. register 전 호출은 fail-closed throw.
+     * @param {string} type - wire type(`hub.*`).
+     * @param {Object} payload
+     * @returns {void}
+     * @private
+     */
+    private _send;
+    /**
+     * envelope 직렬화 후 소켓 송신.
+     * @param {Object} envelope
+     * @returns {void}
+     * @private
+     */
+    private _sendEnvelope;
+    /**
+     * 수신 메시지를 등록된 핸들러에 디스패치. 핸들러 throw 는 격리(다른 핸들러 보호).
+     * @param {import('../lib/hub-protocol.js').HubEnvelope} msg
+     * @returns {void}
+     * @private
+     */
+    private _dispatch;
+    /**
+     * 라이프사이클 이벤트 emit (RECONNECTED 등). 디스패치와 같은 핸들러 맵을 쓰되 인자는 이벤트 데이터.
+     * @param {string} event - {@link MegaHubLink.EVENTS} 값.
+     * @param {Object} data
+     * @returns {void}
+     * @private
+     */
+    private _emit;
+    /** heartbeat 루프 시작 (heartbeatMs>0 일 때만). 프로세스 종료 막지 않게 unref. @private */
+    private _startHeartbeat;
+    /** heartbeat 루프 정지. @private */
+    private _stopHeartbeat;
+}
+import { WebSocket } from 'ws';

package/types/core/i18n.d.ts

@@ -0,0 +1,178 @@
+/**
+ * i18n 등록 결과 요약(디버그·테스트용).
+ * @typedef {Object} I18nSummary
+ * @property {boolean} enabled - 등록 여부.
+ * @property {string} default - 기본 언어.
+ * @property {string} fallback - fallback 언어.
+ * @property {string[]} available - 지원 언어 목록.
+ * @property {string} cookieName - locale 쿠키 이름.
+ * @property {boolean} autoComplete - saveMissing(dev 자동 키 생성) 활성 여부.
+ * @property {import('i18next').i18n | null} instance - 생성된 i18next 인스턴스(미등록 시 null).
+ */
+/**
+ * 정규화된 i18n 설정.
+ * @typedef {Object} NormalizedI18n
+ * @property {string} default
+ * @property {string} fallback
+ * @property {string[]} available
+ * @property {string} cookieName
+ * @property {{ enabled: boolean, dir: string|null, debounceMs: number }} autoComplete
+ * @property {string|null} localesDir
+ * @property {Record<string, any>} resources
+ * @property {boolean} exposeTranslations
+ * @property {string} translationsPath
+ */
+/**
+ * 앱 `i18n` config 를 정규화한다. falsy 면 미옵트인(`null`).
+ *
+ * 잘못된 형태는 **fail-fast** 로 throw 한다(silent 보정 X). `available` 이 배열이 아니거나 비었으면
+ * 부팅 에러로 드러내, locale 미설정이 런타임에 조용히 fallback 으로 뭉개지지 않게 한다.
+ *
+ * @param {unknown} i18n - `MegaI18nAppConfig`(default/available/fallback/cookieName/autoComplete/...).
+ * @returns {NormalizedI18n | null}
+ * @throws {Error} `available` 가 비-배열/빈 배열 등 명백한 오설정.
+ */
+export function normalizeI18n(i18n: unknown): NormalizedI18n | null;
+/**
+ * `<dir>/<scope>/<lng>.json` 디렉터리 구조에서 locale 리소스를 로드한다(ADR-039 scope 분리 레이아웃,
+ * 04-data-models §768). 파일이 없으면 건너뛴다(빈 namespace). 부팅 시 1회 동기 읽기.
+ *
+ * @param {string|null} dir - locale 루트 디렉터리. null 이면 빈 리소스.
+ * @param {object} opts
+ * @param {string[]} opts.available - 로드할 언어 목록.
+ * @param {{ warn?: Function }} [opts.logger]
+ * @returns {Record<string, Record<string, object>>} `{ <lng>: { <scope>: {...} } }` i18next resources 형태.
+ */
+export function loadLocaleResources(dir: string | null, { available, logger }?: {
+    available: string[];
+    logger?: {
+        warn?: Function;
+    };
+}): Record<string, Record<string, object>>;
+/**
+ * saveMissing 디바운스 writer 를 만든다 — axion 패턴(ADR-037).
+ *
+ * `(lng, scope, key, value)` 누락 키를 모아 `<dir>/<scope>/<lng>.json` 파일에 **기존 키 보존**하며
+ * 병합 저장한다. 같은 파일의 연속 호출은 `debounceMs` 동안 흡수(타이머 1개)하고, flush 시:
+ *   1. 기존 파일 읽어 base 로(없으면 {}),
+ *   2. 모아둔 누락 키를 dot-notation 으로 set(기존 키 안 건드림),
+ *   3. tmp 파일 작성 → `rename`(원자적 쓰기 — 부분 파일 노출 방지),
+ *   4. `timer.unref()` 라 보류 중 타이머가 프로세스 종료를 막지 않음.
+ *
+ * 쓰기 실패는 비치명적(dev 편의 기능) — warn 후 다음 호출에 재시도.
+ *
+ * @param {object} opts
+ * @param {string} opts.dir - locale 루트 디렉터리.
+ * @param {number} opts.debounceMs
+ * @param {{ debug?: Function, warn?: Function }} [opts.logger]
+ * @returns {{ enqueue: (lng: string, scope: string, key: string, value: string) => void, flushAll: () => Promise<void>, _pendingCount: () => number }}
+ */
+export function createMissingKeyWriter({ dir, debounceMs, logger }: {
+    dir: string;
+    debounceMs: number;
+    logger?: {
+        debug?: Function;
+        warn?: Function;
+    };
+}): {
+    enqueue: (lng: string, scope: string, key: string, value: string) => void;
+    flushAll: () => Promise<void>;
+    _pendingCount: () => number;
+};
+/**
+ * 요청 Cookie 헤더에서 locale 쿠키를 읽어 유효 언어로 결정한다(ADR-038 — 쿠키만).
+ *
+ * 쿠키가 없거나 `available` 에 없는 값이면 `default` 로 폴백한다(조용한 클램프 — 변조·구식 쿠키 방어).
+ *
+ * @param {string|undefined} cookieHeader - `req.headers.cookie`.
+ * @param {object} opts
+ * @param {string} opts.cookieName
+ * @param {string[]} opts.available
+ * @param {string} opts.default
+ * @returns {string} 결정된 언어.
+ */
+export function detectLocale(cookieHeader: string | undefined, { cookieName, available, default: def }: {
+    cookieName: string;
+    available: string[];
+    default: string;
+}): string;
+/**
+ * Fastify 인스턴스에 i18n(`i18next`) 을 자동 등록한다 — 요청별 언어 결정·`req.t`·scope 번들·관측성.
+ *
+ * `i18n` 이 falsy 면 **미등록**(옵트인). session.js / multipart.js 형제 패턴. 호출 순서는 라우트 등록
+ * 이전 어디든 무방하다(onRequest hook + request 부착이라 라우트 순서와 무관).
+ *
+ * @param {import('fastify').FastifyInstance} fastify - 대상 앱 Fastify 인스턴스.
+ * @param {Object} opts
+ * @param {unknown} opts.i18n - `MegaI18nAppConfig`. falsy 면 미등록.
+ * @param {string} [opts.appName] - 앱 이름(메트릭 라벨·로그용).
+ * @param {{ debug?: Function, warn?: Function }} [opts.logger] - 흐름 길목 debug 로그(선택).
+ * @returns {I18nSummary}
+ */
+export function registerI18n(fastify: import("fastify").FastifyInstance, { i18n, appName, logger }?: {
+    i18n: unknown;
+    appName?: string;
+    logger?: {
+        debug?: Function;
+        warn?: Function;
+    };
+}): I18nSummary;
+/** locale 쿠키 기본 이름 (04-data-models §394 `cookieName: 'mega.lang'`). */
+export const DEFAULT_I18N_COOKIE: "mega.lang";
+/** scope 분리 고정 namespace 2종 (ADR-039). server=에러·검증, client=SPA UI. */
+export const I18N_SCOPES: readonly string[];
+/** server scope = 기본 namespace — `ctx.t()` 가 자동 선택(ADR-039). */
+export const DEFAULT_SCOPE: "server";
+/** saveMissing 디바운스 기본값 (ms, ADR-037 axion 패턴). */
+export const DEFAULT_DEBOUNCE_MS: 500;
+/**
+ * i18n 등록 결과 요약(디버그·테스트용).
+ */
+export type I18nSummary = {
+    /**
+     * - 등록 여부.
+     */
+    enabled: boolean;
+    /**
+     * - 기본 언어.
+     */
+    default: string;
+    /**
+     * - fallback 언어.
+     */
+    fallback: string;
+    /**
+     * - 지원 언어 목록.
+     */
+    available: string[];
+    /**
+     * - locale 쿠키 이름.
+     */
+    cookieName: string;
+    /**
+     * - saveMissing(dev 자동 키 생성) 활성 여부.
+     */
+    autoComplete: boolean;
+    /**
+     * - 생성된 i18next 인스턴스(미등록 시 null).
+     */
+    instance: import("i18next").i18n | null;
+};
+/**
+ * 정규화된 i18n 설정.
+ */
+export type NormalizedI18n = {
+    default: string;
+    fallback: string;
+    available: string[];
+    cookieName: string;
+    autoComplete: {
+        enabled: boolean;
+        dir: string | null;
+        debounceMs: number;
+    };
+    localesDir: string | null;
+    resources: Record<string, any>;
+    exposeTranslations: boolean;
+    translationsPath: string;
+};

package/types/core/index.d.ts

@@ -0,0 +1,28 @@
+export { MegaApp } from "./mega-app.js";
+export { MegaWsPresence } from "./ws-presence.js";
+export { MegaServer } from "./mega-server.js";
+export { MegaService } from "./mega-service.js";
+export { MegaCluster } from "./mega-cluster.js";
+export { loadRoutes } from "./routes-loader.js";
+export { buildErrorHandler } from "./error-mapper.js";
+export { loadAndValidateConfig } from "./config-loader.js";
+export { MegaWebSocketController } from "./ws-controller.js";
+export { MegaHubLink } from "./hub-link.js";
+export { createSessionCleanupSchedule } from "./session-cleanup-schedule.js";
+export { Router, MegaRouteError } from "./router.js";
+export { bootApp, buildBootContext } from "./boot.js";
+export { wrapEnvelope, errorEnvelope, synthesizeEnvelopeResponseSchema, ENVELOPE_MARK } from "./envelope.js";
+export { buildHttpPipeline, wrapPreHandler, composeTransform, composeAfter } from "./pipeline.js";
+export { ajvErrorToValidationError, MAX_VALIDATION_DETAILS } from "./ajv-mapper.js";
+export { buildHttpCtx, getHttpCtx, getLazyHttpCtx, buildAdapterAccessors } from "./ctx-builder.js";
+export { createWsMessage, validateWsMessage, parseWsMessage, generateMessageId, WS_MESSAGE_SCHEMA, WS_PROTOCOL_VERSION, WS_TYPE_PATTERN } from "./ws-message.js";
+export { MegaWsConnection, driveWsConnection, createPlainCodec, createAspCodec, rejectUpgrade, CLOSE_CODE_DECRYPT_FAILED, CLOSE_CODE_INTERNAL_ERROR } from "./ws-upgrade.js";
+export { buildPerMessageDeflate, checkCompressionConfig, COMPRESSION_DEFAULTS } from "./ws-compression.js";
+export { validateGlobalConfig, validateAppConfig, validateHostCollisions } from "./config-validator.js";
+export { registerSecurityPlugins, DEFAULT_RATE_LIMIT } from "./security.js";
+export { registerSession, generateSid, readSession } from "./session.js";
+export { createSessionStore, SESSION_STORE_DRIVERS } from "./session-store.js";
+export { registerI18n, normalizeI18n, detectLocale, loadLocaleResources, createMissingKeyWriter, DEFAULT_I18N_COOKIE, I18N_SCOPES } from "./i18n.js";
+export { registerTemplate, MegaTemplate, normalizeViews, resolveViewPath, renderView, VIEW_ENGINE } from "./template.js";
+export { registerStaticAssets, normalizeStaticAssets, DEFAULT_STATIC_PREFIX } from "./static-assets.js";
+export { registerOpenapi, normalizeOpenapi, DEFAULT_OPENAPI_PATH } from "./openapi.js";