mega-framework 0.1.10 → 0.1.11

package/types/core/mega-app.d.ts

@@ -309,6 +309,16 @@ export class MegaApp {
      * @returns {import('./ctx-builder.js').AdapterAccessors}
      */
     get adapterAccessors(): import("./ctx-builder.js").AdapterAccessors;
+    /** 분산 락 사용자 API(ADR-226) — `ctx.lock` 과 같은 process manager(콜러블 + .with/.acquire/...). @returns {any} */
+    get lock(): any;
+    /** 메시지 버스 사용자 API(ADR-227) — `ctx.bus` 와 같은 process manager(콜러블 + .emit/.on/.request/...). @returns {any} */
+    get bus(): any;
+    /** 앱 별명 → 공유 DB 어댑터(ADR-102). 미선언 별명은 throw. @param {string} alias @returns {import('../adapters/mega-adapter.js').MegaAdapter} */
+    db(alias: string): import("../adapters/mega-adapter.js").MegaAdapter;
+    /** 앱 별명 → 공유 캐시 어댑터(ADR-102). 미선언 별명은 throw. @param {string} alias @returns {import('../adapters/mega-adapter.js').MegaAdapter} */
+    cache(alias: string): import("../adapters/mega-adapter.js").MegaAdapter;
+    /** 앱 로거(pino, ADR-141) — `ctx.log` 의 요청 바인딩 없는 베이스 로거. @returns {any} */
+    get log(): any;
     /**
      * 이 앱의 서비스 레지스트리(name → 클래스, ADR-148). 요청 ctx 빌더가 `ctx.services.<name>` lazy DI 의
      * 클래스 lookup 출처로 읽는다. 부팅 orchestrator 가 `setServiceRegistry` 로 채운다.

package/types/core/scope-registry.d.ts

@@ -10,5 +10,11 @@ export const GLOBAL_ONLY_KEYS: readonly string[];
 export const APP_ONLY_KEYS: readonly string[];
 /** Shared-Reference 키 — 전역 services 의 키만 참조 가능 */
 export const SHARED_REFERENCE_KEYS: readonly string[];
+/**
+ * Dual-scope 키 — 글로벌(mega.config.js)과 앱(app.config.js) **양쪽**에 정의 가능 (ADR-229).
+ * 글로벌은 fallback, 앱별 정의가 있으면 그 앱은 자기 manager 를 쓴다(앱별 lock/bus backend 분리). GLOBAL_ONLY_KEYS
+ * 에도 그대로 남겨(글로벌 정의 허용) 두고, validateAppConfig 가 이 목록을 wrong_scope 예외로 둔다.
+ */
+export const DUAL_SCOPE_KEYS: readonly string[];
 export const ALL_GLOBAL_KEYS: readonly string[];
 export const ALL_APP_KEYS: readonly string[];

package/types/index.d.ts

@@ -18,7 +18,7 @@ export { registerAspPlugin } from "./lib/asp/plugin.js";
 export { MegaAspTerminator } from "./lib/asp/ws-terminator.js";
 export { normalizeAspConfig } from "./lib/asp/config.js";
 export { MegaHubLink } from "./core/hub-link.js";
-export { MegaApp, MegaServer, Router, loadAndValidateConfig, loadRoutes, bootApp, buildBootContext, MegaService, MegaCluster, wrapEnvelope, errorEnvelope, buildErrorHandler, ajvErrorToValidationError, MegaWebSocketController, createWsMessage, validateWsMessage, parseWsMessage, generateMessageId, WS_MESSAGE_SCHEMA, WS_PROTOCOL_VERSION, WS_TYPE_PATTERN, buildHttpCtx, buildAdapterAccessors, registerSession, generateSid, readSession, createSessionStore, SESSION_STORE_DRIVERS, createSessionCleanupSchedule } from "./core/index.js";
+export { MegaApp, MegaServer, Router, loadAndValidateConfig, loadRoutes, bootApp, buildBootContext, getApp, hasApp, MegaService, MegaCluster, wrapEnvelope, errorEnvelope, buildErrorHandler, ajvErrorToValidationError, MegaWebSocketController, createWsMessage, validateWsMessage, parseWsMessage, generateMessageId, WS_MESSAGE_SCHEMA, WS_PROTOCOL_VERSION, WS_TYPE_PATTERN, buildHttpCtx, buildAdapterAccessors, registerSession, generateSid, readSession, createSessionStore, SESSION_STORE_DRIVERS, createSessionCleanupSchedule } from "./core/index.js";
 export { runCli, parseArgs, runWorkerHost, runSchedulerHost, dispatchPluginCommand, USAGE } from "./cli/index.js";
 export { MegaHttpError, MegaValidationError, MegaAuthError, MegaForbiddenError, MegaNotFoundError, MegaConflictError, MegaInternalError } from "./errors/http-errors.js";
 export { buildLogger, buildLoggerOptions, buildTargets } from "./lib/mega-logger.js";

package/types/lib/mega-job-queue.d.ts

@@ -7,7 +7,7 @@ export const DEFAULT_DLQ_MAX_AGE_MS: number;
 export const DEFAULT_RUN_TIMEOUT_MS: number;
 /**
  * @typedef {Object} MegaJobQueueOptions
- * @property {import('nats').NatsConnection} nc - **연결된** NatsConnection(`ctx.bus(alias).native`).
+ * @property {import('@nats-io/nats-core').NatsConnection} nc - **연결된** NatsConnection(`ctx.bus(alias).native`).
  * @property {number} [ackWaitMs=30000] - consumer ack 대기(ms). 초과 시 JetStream 재전달. `working()`
  *   하트비트가 이 값의 절반마다 lease 를 갱신한다.
  * @property {number} [maxDeliver=5] - JetStream 최대 전달 횟수(워커 크래시 재전달 backstop).
@@ -31,6 +31,17 @@ export const DEFAULT_RUN_TIMEOUT_MS: number;
  * @property {any} [result] - run 반환값(성공 시).
  * @property {Error} [error] - 실패 사유(실패 시).
  */
+/**
+ * ensureReady 가 lazy import 로 채우는 v3 nats 심볼 묶음(ADR-225). enum·nanos·not-found 에러 클래스만
+ * 추려 보관해 잡 미사용 앱에 nats 전체 로드를 강제하지 않는다.
+ * @typedef {Object} MegaJobQueueNatsBundle
+ * @property {typeof import('@nats-io/jetstream').RetentionPolicy} RetentionPolicy
+ * @property {typeof import('@nats-io/jetstream').AckPolicy} AckPolicy
+ * @property {typeof import('@nats-io/jetstream').StorageType} StorageType
+ * @property {typeof import('@nats-io/nats-core').nanos} nanos
+ * @property {typeof import('@nats-io/jetstream').JetStreamApiError} JetStreamApiError
+ * @property {typeof import('@nats-io/jetstream').JetStreamApiCodes} JetStreamApiCodes
+ */
 /**
  * JetStream 잡 큐 런타임. {@link MegaJob} 클래스를 받아 enqueue/consume·재시도·DLQ 를 처리한다.
  *
@@ -115,19 +126,19 @@ export class MegaJobQueue extends EventEmitter<any> {
      * in-flight Promise 가 reject 되지 않게 — MegaScheduler #fire 와 동일 불변식). 내부/테스트용 seam 이라
      * `_` 접두사(어댑터 `_connect` 컨벤션).
      *
-     * @param {MegaJob} instance @param {Record<string, any>} ctx @param {import('nats').JsMsg} msg
+     * @param {MegaJob} instance @param {Record<string, any>} ctx @param {import('@nats-io/jetstream').JsMsg} msg
      * @param {ReturnType<typeof resolveJobRetryConfig>} retryConfig @param {string} subject
      * @param {number} [runTimeoutMs] - run 전체(재시도 포함) 상한(ms). 미지정 시 큐 디폴트, 0 = 무제한.
      * @returns {Promise<MegaJobHandleResult>}
      */
-    _handleMessage(instance: MegaJob, ctx: Record<string, any>, msg: import("nats").JsMsg, retryConfig: ReturnType<typeof resolveJobRetryConfig>, subject: string, runTimeoutMs?: number): Promise<MegaJobHandleResult>;
+    _handleMessage(instance: MegaJob, ctx: Record<string, any>, msg: import("@nats-io/jetstream").JsMsg, retryConfig: ReturnType<typeof resolveJobRetryConfig>, subject: string, runTimeoutMs?: number): Promise<MegaJobHandleResult>;
     #private;
 }
 export type MegaJobQueueOptions = {
     /**
      * - **연결된** NatsConnection(`ctx.bus(alias).native`).
      */
-    nc: import("nats").NatsConnection;
+    nc: import("@nats-io/nats-core").NatsConnection;
     /**
      * - consumer ack 대기(ms). 초과 시 JetStream 재전달. `working()`
      * 하트비트가 이 값의 절반마다 lease 를 갱신한다.
@@ -183,6 +194,18 @@ export type MegaJobHandleResult = {
      */
     error?: Error;
 };
+/**
+ * ensureReady 가 lazy import 로 채우는 v3 nats 심볼 묶음(ADR-225). enum·nanos·not-found 에러 클래스만
+ * 추려 보관해 잡 미사용 앱에 nats 전체 로드를 강제하지 않는다.
+ */
+export type MegaJobQueueNatsBundle = {
+    RetentionPolicy: typeof import("@nats-io/jetstream").RetentionPolicy;
+    AckPolicy: typeof import("@nats-io/jetstream").AckPolicy;
+    StorageType: typeof import("@nats-io/jetstream").StorageType;
+    nanos: typeof import("@nats-io/nats-core").nanos;
+    JetStreamApiError: typeof import("@nats-io/jetstream").JetStreamApiError;
+    JetStreamApiCodes: typeof import("@nats-io/jetstream").JetStreamApiCodes;
+};
 import { EventEmitter } from 'node:events';
 import { MegaJob } from './mega-job.js';
 import { resolveJobRetryConfig } from './mega-job.js';

package/sample/simple/node_modules/.vite/vitest/da39a3ee5e6b4b0d3255bfef95601890afd80709/results.json

@@ -1 +0,0 @@
-{"version":"4.1.8","results":[[":test/apps/main/index.test.js",{"duration":1.6905000000000001,"failed":false}]]}